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刘 杰 毕业 于 浙江 大 学 信 电 系 通信 工程 专业 ， 获 工学 博士 学 位 ， 
现 为 硕士 生 导师 ,兼职 教授 。 长 期 从 事 谋 入 式 器 件 的 研究 与 开发 ,特别 是 
近 3 ~ 4 年 , 夜以继日 地 潜心 钻研 基于 模型 的 设计 , 这 项 最 近 几 年 才 
在 全 球 掀起 的 新 技术 .致力 于 宣传 、 推 广 基 于 模型 的 设计 在 我 国 的 应 
用 和 普及 , 已 经 出 版 了 国内 第 一 部 基于 模型 设计 的 专著 (基于 模型 的 
设计 及 其 嵌入 式 实 现 》 


\ 内 容 精华 
本 书 采用 了 先进 的 产品 开发 思想 一 一 基于 模型 设计 的 方法 , 并 以 MATLAB R2010b 为 软件 平台 。 让 工 
程 师 在 可 视 化 的 MATLAB 统一 开发 环境 中 , 一 边 进行 需求 分 析 、 算 法 研究 、 模 型 与 需求 分 析 的 双向 跟踪 、 
模型 验证 与 优化 ; 另 一 边 进行 自动 生成 C 代码 的 软件 在 环 测试 、 处 理 器 在 环 测试 、 代 码 的 有 效 性 分 析 、 代 
码 与 模型 的 双向 跟踪 、 代 码 优化 、 硬 件 测试 等 , 让 算法 到 炭 入 式 实时 C 代码 的 生成 一 步 到 位 、 一 次 成 功 , 避 
免 传 统 开发 MCU 器 件 ,前 期 投入 大 、 开 发 周期 长 一般 需要 重复 多 次 才能 成 功 的 台 端 。 
实现 了 51 单片机 、 英 飞 凑 C166 单片机 .dsPIC3x 数字 信号 处 理 器 .ARM 处 理 器 的 快速 开发 , 其 资金 
投入 .工作 量 和 所 需 花 费时 间 只 占 传统 方法 的 1/3 ~ 1/2, 有 效 地 规避 MCU 应 用 开发 的 潜在 市 场 风 险 。 
书 中 着 重 介 绍 了 有 限 状 态 机 Stateflow 描述 MCU 编程 的 特点 ， 让 一 些 复杂 或 临 涩 的 逻辑 关系 变 得 异 


常 简单 。 Mb 


.读者 对 象 二 
本 书 可 作为 MCU 器 件 开发 的 技术 手册 , 也 可 作为 高 校 的 嵌入 式 开 发 ,特别 是 基于 樟 : 
是 一 本 很 好 的 Stateflow 和 Simulink 高 级 建 模 与 验证 的 工具 书 。 
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内 容 简 介 


本 书 以 基于 模型 的 设计 在 MCU 中 的 应 用 为 主线 ,分 三 部 分 介绍 全 书 。 

第 一 部 分 ,深入 剖析 了 Stateflow 的 建 模 与 应 用 ,以 及 Simulink 建 模 与 调试 ;介绍 了 新 版 
MATLAB 的 特色 功能 与 R2010b 版 中 Embedded MATLAB 的 编程 规范 和 新 的 编程 与 调试 模 丈 ; 
最 后 着 重 讨 论 了 用 户 驱动 模块 的 创建 过 程 与 应 用 实例 等 。 

第 二 部 分 ,演示 了 简化 的 基于 模型 设计 , 即 基于 模型 的 8051 英 飞 凌 C166.Microchip dsPIC、 
ARM 等 MCU 中 的 快速 开发 ,并 在 Proteus 中 进行 虚拟 硬件 测试 ,使 读者 直观 地 感受 到 在 可 视 化 
的 开发 环境 中 ,从 算法 验证 到 虹 人 式 C 代码 自动 生成 一 步 到 位 的 方便 与 高 效 。 

第 三 部 分 ,以 直流 电动 机 的 PID 控制 模型 为 例 , 介 绍 了 满足 DO 一 178b 航空 电子 规范 的 完整 
基于 模型 设计 在 ARM 上 的 实现 。 其 流程 包括 可 执行 .可 跟踪 的 需求 分 析 / 技 术 规范 Model Ad- 
vior 测试 ,系统 测试 .设计 测试 . 浮 点 模型 到 定点 模型 的 自动 转换 与 定 标 ,为 特定 芯片 生成 嵌 人 式 C 
代码 .软件 /硬件 在 环 测试 . 嵌 人 式 实 时 C 代码 的 自动 生成 ,最 后 是 手工 底层 驱动 代码 与 自动 代码 
的 整合 等 ,这 部 分 是 本 书 的 总 结 与 核心 。 

本 书 可 作为 航天 军工 ,汽车 电子 ,通信 与 信息 处 理 , 电 力 等 行业 的 工程 师 从 事 MCU 开发 时 的 技 
术 手 册 ,也 可 作为 高 校 电 类 专业 的 MCU 开发 或 基于 模型 设计 的 教材 ,同时 也 是 Sithulink/Sateflow 高 
级 建 模 与 验证 的 参考 书 , 另 外 也 为 广大 高 校 学 生 ( 本 、 硕 . 博 ) 做 毕业 设计 提供 了 一 种 高 效 、 快 捷 的 软 
件 实 现 方法 。 
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20 世纪 90 年 代 初 ,航空 航天 .汽车 等 行业 中 开始 大 量 使 用 微 控 制 器 单元 ,开发 人 员 首 先 
发 现 通 过 建 模 与 仿真 ,可 以 大 大 提高 MCU 系统 的 开发 效率 。 到 了 20 世纪 90 年 代 中 期 ,出现 
了 代码 自动 生成 技术 ,使 基于 模型 设计 的 雏形 随 之 显现 。 

近 十 几 年 来 ,信息 技术 飞速 发 展 , 产 品 中 软件 控制 代码 呈 爆 炸 性 增长 的 趋势 。 一 台中 高 档 
汽车 的 控制 代码 超过 500 万 行 , 第 四 代 战 机 F- 35 的 软件 代码 则 高 达 1500 万 行 , 它 们 都 超过 
了 人 类 第 一 次 登 月 一 一 阿波 罗 计 划 中 软件 代码 的 规模 。 随 着 代码 量 的 迅速 膨胀 ,传统 的 手工 
编程 模式 面临 着 产品 开发 周期 被 迫 拉 长 ,开发 成 本 成 倍增 加 ,同时 产品 可 靠 性 也 难以 保障 等 诸 
多 难以 克服 的 困难 ,已 很 难 适应 当今 科技 发 展 的 需要 ,严重 制约 了 我 国 现代 化 的 进展 。 目 前 ， 
世界 上 已 有 数 家 具有 前 瞻 性 的 软件 公司 推出 了 自己 的 基于 模型 设计 软件 ,如 SCADE .dSpace、 
MATLAB 等 ,它们 是 世界 科技 创新 的 技术 源泉 。 空 客 A380 .美国 通用 公司 的 混合 动力 汽车 、 
我 国 二 汽 新 能 源 汽车 的 电池 管理 系统 .喷气 发 动机 洛克 -马丁 公司 的 联合 攻击 机 FF- 35 等 重 
大 创新 项 目 ,都 采用 了 基于 模型 的 设计 。 

作者 自 2000 年 开始 关注 自动 代码 生成 技术 ,以 及 后 来 的 基于 模型 设计 ,尤其 是 最 近 三 四 
年 来 ,夜以继日 地 钻研 基于 模型 设计 的 思想 ,阅读 浏览 了 超过 10 万 页 的 外 文 资料 与 技术 文档 ， 
做 了 大 量 基 于 模型 设计 的 实验 ,撰写 了 国内 第 一 本 基于 模型 设计 的 专著 一 一 (基于 模型 的 设计 
及 其 内 人 式 实 现 》)。 也 许 是 外 国政 府 或 国际 知名 企业 对 这 项 新 技术 有 所 保留 ,网 上 很 难 找到 有 
价值 的 开发 实例 ,美国 CRC 出 版 社 2009 年 11 月 出 版 的 4Model-Based Design for Embedded 
Systems) 一 书 , 也 仅 是 作 了 知识 性 的 介绍 。 

通过 这 几 年 作者 及 实验 室 全 体 同 仁 的 共同 奋斗 ,基本 掌握 了 基于 模型 的 设计 方法 ,并 已 将 
此 技术 推 向 了 实用 阶段 。 现 将 近年 的 研究 成 果 整 理 成 册 ,以 期 能 为 我 国 的 科技 创新 ,建立 创新 
型 国家 贡献 微薄 之 力 。 

考虑 到 国内 有 众多 的 MATLAB 用 户 ,本 书 以 MATLAB R2010b 为 软件 平台 介绍 基于 模 
型 设计 的 方法 。 书 中 涉及 8051 单片机 、 英 飞 凌 C166 单片机 、Microchip dsPIC 数字 信和 号 控制 
器 .ARM 处 理 器 的 基于 模型 设计 的 开发 ,其 优势 在 于 :在 统一 的 可 视 化 开发 测试 平台 上 ,使 用 
户 轻 松 地 从 设计 概念 到 实现 一 气 呵 成 ,减少 不 必要 的 重复 劳动 ,这 将 大 大 缩短 项 目的 开发 周 
期 .减少 资金 投入 .提高 代码 的 稳健 性 与 一 致 性 。 一 些 对 安全 性 要 求 不 高 的 产品 几 周 就 可 以 完 
成 ,有 效 地 规避 了 潜在 的 市 场 风险 ,使 企业 在 激烈 的 市 场 竞 争 中 占 得 先 机 ;满足 DO-178b 航空 
电子 规范 的 工作 流程 ,使 基于 模型 设计 能 提供 解决 那些 对 于 安全 性 .可靠 性 要 求 极 高 甚至 近乎 
苛刻 的 设计 要 求 的 绝 好 方案 。 

全 书 可 分 三 个 部 分 :1 一 4 章 为 第 一 部 分 ,介绍 模型 的 创建 与 调试 ,是 基于 模型 设计 的 起 点 
与 核心 ;5 一 8 章 为 第 二 部 分 ,介绍 基于 模型 的 8051 单片机 、 英 飞 凌 C166 单片机 、Microchip 
dsPIC3x 数字 信和 号 控制 器 .AR:4 处 理 器 的 快速 开发 ;第 9 章 为 第 三 部 分 ,以 直流 电动 机 的 PID 
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1.1 压缩 文件 . 
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MATLAB 是 一 种 高 度 集成 化 的 交互 式 编程 环境 ,大 到 航空 航天 ,小 到 计算 二 元 矩阵 的 逆 
和 矩阵 ,都 可 以 看 到 MATLAB 的 身影 ,其 优势 在 于 算法 研究 .数据 分 析 与 可 视 化 .并行 计算 等 方 
面 。 随 着 信息 技术 和 计算 机 软 硬 件 的 不 断 发 展 ,MATLAB 的 应 用 领域 得 到 了 广泛 的 拓展 , 主 
要 包括 电机 控制 .飞行 建 模 、 音 视频 处 理 .通讯 .测试 与 测量 、 财 务 建 模 分 与 分 析 等 。 

MATLAB 是 基于 模型 设计 的 起 点 ,本 章 仅 对 新 版 MATLAB 软件 的 一 些 特色 功能 、 
MATLAB 程序 的 编写 及 调试 方法 .Embedded MATLAB 的 编程 规范 作 简 单 介绍 ,更 详细 的 
内 容 请 读者 参考 MathWorks 公司 的 相关 技术 手册 及 各 种 著作 。 

本 章 的 主要 内 容 如 下 : 

@ MATLAB 开发 环境 新 功能 。 

@ M 文件 编写 .调试 与 发 布 。 

@ Embedded MATLAB。 


1.1 MATLAB R2010a 与 2010b 的 若干 更 新 


MATLAB R2010a 与 R2010b 针对 MATLAB 和 Simulink 新 增加 了 若干 功能 ,并 对 其 他 
多 款 产 品 进行 了 更 新 和 缺陷 修复 ,本 章 首先 列 出 MATLAB 新 增加 及 加 强 的 功能 。 


1， 开发 环境 (MATLAB 7. 10) 


@ 新 增 了 解压 缩 功 能 ,能 够 自动 压缩 和 解压 当前 文件 夹 的 文件 和 文件 夹 。 

@ 提示 “当前 文件 夹 " 是 否 包 含 在 MATLAB 搜索 路 径 列 表 。 

@ MATLAB 变量 编辑 器 中 的 表格 填写 功能 ,可 支持 局 部 变量 . 子 函 数 和 散 套 函数 。 

@ 扩展 了 曲线 拟 合 .滤波 器 设计 、 图 像 处 理 与 信号 处 理工 具 箱 绘图 选择 界面 的 图 形 访问 
能 力 。 

@ 使 用 比较 工具 比较 文件 时 ,可 高 亮 显示 各 行 的 变化 ;比较 文件 夹 时 ,可 按 名 称 . 类 型 大 
小 或 时 间 排 列 比 较 结果 。 
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2。 


芽 


开发 环境 (MATLAB 7. 11 ) 


@ 编辑 器 可 高 亮 显 示 变 量 或 子 函数 的 所 有 使 用 情况 ,并 识别 共享 变量 。 

@ 可 以 将 ZIP 文件 看 作文 件 夹 进行 操作 。 

@ 预览 当前 文件 夹 的 图 像 文 件 内 容 , 并 以 星 号 提示 MATLAB 文件 是 否 保 存 。 

@ 在 绘图 选择 界面 中 可 以 访问 系统 标识 .制图 和 生物 信息 学 工具 箱 的 图 形 。 

@ 使 用 比较 工具 能 够 比较 ZIP 文件 .文件 坎 和 Simulink 表单 ,并 改善 了 MAT 文件 比较 
性 能 。 


语言 和 编程 (MATLAB 7. 11) 
@ 可 使 用 若干 组 已 命名 的 值 ,自行 定义 枚 举 数 据 类 型 。 


.数学 (MATLAB 7. 11 ) 


@ 支持 64 位 整 型 数据 的 算法 。 


. 文件 MO 和 外 部 接口 连接 (MATLAB 7. 11 ) 


@ 新 增 了 VideoWriter 对 象 , 可 创建 大 于 2GB 的 MPEG 和 非 压 缩 AVI 文件 。 

@ 支持 netCDF0. 1 ,可 将 HDF5 用 作 netCDF API 的 数据 存储 层 。 

@ 加 强 了 与 Microsoft .NET framework 的 接口 ,支持 与 Microsoft Office 产品 的 授权 和 交互 。 
根据 本 书 的 定位 ,以 下 选取 几 个 开发 环境 典型 的 新 功能 , 作 简 要 说 明 。 


1.1.1 压缩 文件 


为 了 备份 文件 .节省 存储 空间 .与 他 人 共享 ,通常 是 使 用 第 三 方 压缩 程序 将 文件 打包 压缩 ， 


而 MATLAB 7. 10 集成 了 压缩 功能 。 在 目录 浏览 器 可 以 直接 建立 或 解压 ZIP 格式 的 压缩 文 


件 。 


1 


MATLAB 7. 11 进而 又 可 将 ZIP 文件 看 作文 件 夹 进行 操作 。 
创建 压缩 文件 
选中 需要 打包 的 文件 ,选择 右键 菜单 项 Creat Zip File, 如 图 1. 1. 1 所 示 。 在 当前 目录 建 


立 以 Untitledl 为 名 的 ZIP 压缩 文件 ,如 图 1.1. 2 所 示 。 


志 GMATLAB book 上 z 姜 


1 Narme ^ 


避 ，G MATLAB book ”zip 





图 1.1.1 创建 压缩 文件 图 1.1.2 命名 压缩 文件 


< 
二 ， 了 
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2. 压缩 文件 管理 
单 击 压缩 包 左 侧 的 十 号 ,将 其 看 作 一 个 文件 夹 展开 显示 ,如 图 1. 1. 3 所 示 。 双 击 压缩 包 内 
的 各 文件 ,可 执行 对 应 的 操作 ,例如 打开 M 文件 ,加 载 MAT 数据 等 。 不 过 这 些 文件 是 只 读 
的 ,用 户 修改 后 需要 将 其 另存 。 


3. 解压 缩 文 件 
双击 压缩 文件 .选择 压缩 文件 右键 菜单 项 Extract 或 选中 文件 后 按 Enter 键 , 在 当前 目录 
解压 得 到 同名 文件 夹 , 如 图 1. 1.4 所 示 。 当 然 , 如 果 压 缩 包 里 包含 与 当前 目录 下 同名 的 文件 或 
文件 夹 ,在 解压 时 系统 会 提示 用 户 是 否 蔡 换 当 前 文件 。 






所 人 book ， zp 











Name * 
呈 average,mm 
= jleapyear.rmn 
共 ] leapyear_scriptm < book ， zip 》， 万 本 间 - 
扒 ] LTifig 一 
全 LTLm Name ^ 
田 cmmat 


-mmzip.zp 
本 













Lj average.m 
六] jeapyear.m 
全 jeapyear_script,m 
从 ] LTIfig 
千 ] LTIm 
二 LTH.mat | 
由 辐 mmzlip.zip 
大 ] ruku,m | 
| 必 3 ruku_script.m | 






3Vera 吕 ern 





jeapyear.rn 











惟 ] ruku_script,rm 


图 1.1.3 查看 压缩 文件 图 1.1.4 解压 缩 文件 


1.1.2 目录 浏览 器 


对 于 大 型 的 工程 ,脚本 、 函 数 、 数 据 等 文件 可 能 处 于 不 同 的 文件 夹 ,如 果 a 目录 下 的 脚本 文 
件 需 要 调用 b 目录 下 的 函数 与 目录 下 的 数据 ,用 户 可 以 将 bc 目录 添加 到 MATLAB 搜索 
路 径 , 这 类 似 于 C 语言 的 头 文件 。 

单 击 MATLAB 主 窗口 菜单 项 File~>Set Path. .. ,打开 搜索 路 径 对 话 框 ,用 户 可 使 用 左 侧 
的 按钮 增加 或 删除 搜索 路 径 并 调整 路 径 顺 序 , 如 图 1. 1. 5 所 示 。 

使 用 早期 版 本 的 用 户 可 能 感觉 到 ,访问 位 于 不 同文 件 夹 下 的 文件 是 个 很 麻烦 的 过 程 , 需 要 
频繁 地 切换 目录 。 自 MATLAB 7. 9 起 ,目录 浏览 器 改进 了 显示 方式 ,使 用 类 似 于 Windows 
资源 管理 器 的 树 形 结构 ,用 户 可 同时 查看 多 个 目录 下 的 文件 。MATLAB 7. 10 将 搜索 路 径 体 
现在 目录 浏览 器 ,淡化 显示 未 添加 入 搜索 路 径 的 文件 夹 及 下 属 文件 。 
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上 changes take effect immediately. 
MATLAB search path; 


Add Folder 
Se ENprogram Files\MATLABNR2010bvtoclbowAmatlab\lang “| 
Add with Subfolders. EVprogram Files\MATLAB\R2010b\toolboxmatilab\elmat 
E\Program Files\MATLAB\R2010b\toolboxwmatlabwandfun 
aapqgyeiegae E\program Files\MATLAB\R2010b\toolboxmatlabselfun 
Meoveto Top 让 人 ， 站 ， 
E\program Files\MATLAB\R2010b\toolboxmatjab\specfun 
MeoveU E\program Flles\MATLAB\R2010b\toolboxmatlabvmatfun 
- ENprogram Files\MATLAB\R2010bvtoolboxmatiab\datafun 
本 he EN\pProgram Files\M 太 TLABNR2010b\toolboxmatlab\poflyfun 
一 ER EN\program Files\MATLABV\R2010bvtooclboxmatlab\funfun 
Moveto Bottom E\Program Files\MATLAB\R2010b\toolboxmatlab'\sparfun 
ENpProgram FilesNMATLAB\R2010b\tcclboxmatiab\scribe 
EVprooram Files\MATLAB\R2010b\toolboxmatlabyaraoh2d 赤 
Remove | 4 拓 


ee 一 一 -一 一--- 一 -一 -一 一 一 -一 一 


Se | Gen 0 


| 


1.1.5 MATLABS 搜索 路 径 


用 户 选中 某 文件 夹 ,选择 右键 菜单 项 Add to Path( 或 Remove from Path) ,将 当前 文件 夹 
(或 及 其 子 文 件 夹 ) 加 入 搜索 路 径 ( 或 移 除 ) ,如 图 1. 1.6 所 示 。 


Addte Pathn 从 SejectedFolde15 
Rermeove from path 5eiected Folders and 5uUbfolge95 


图 1.1.6 添加 搜索 路 径 


默认 情况 下 ,加 入 搜索 路 径 的 文件 夹 以 正常 的 亮度 显示 ,未 加 入 搜索 路 径 的 文件 夹 则 淡化 
显示 ,如 图 1. 1.7 所 示 。 这 样 用 户 可 明确 地 分 辨 当前 目录 下 哪些 文件 夹 及 文件 是 可 访问 的 ,从 
而 简化 了 搜索 路 径 的 设置 。 


吕 人 bock 2ip 


Name 


-javeragerm 
如 由 leapyear.rm 
4 leapyear_script.m 
本 ] LTIfig 
机 LTLm 
| LTLm 二 
和 红 悟 mzip.2z2P 


产 ] ruku.m 
rukko_scnptm 上 


--~ 一 一 - - 





图 1.1.7 文件 夹 显示 
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单 击 MATLAB 主 窗 口 菜单 项 File-=>Preferences. . . ,选择 Current Folder 面板 ,其 中 复 选 
项 Indicate inaccessible files 的 功能 与 图 1.1.6 所 示 的 右键 菜单 项 Indicate files not on path 
一 致 , 可 开启 或 关闭 化 显示 功能 。 拖 动 Text and icon transparency 滑 块 , 调 整 痰 化 显示 的 
透明 程度 ,如 图 1. 1. 8 所 示 。 





| 由 -General ~ Current Folier Preferences 
| 负 屎 eyboard 
| 包 -onts History 

-Colors 
| CodeAnalyzer Number of mmost recent directories to save ， 习 叶 
| Toolbars 

Command Window Refresh 
《ommand History 


| 
[ 


包 EditoyDebugger 园 Auto-refresh View from file System 


Number of seconds between auto-refresh: 3 全 


Path indhcation 






局 | jmdscate inaccessible fijes ([e.9. not on path， Private folders) 








Text and icon transparency: Sa 
Time Series Tools | 
由 有 gure Copy Template | | Show tooltip explaining why files are Inacce5s 由 |e 
Compller 二 
Report Generator 县 on Path 
SystemrnTest : 


二 Samrnle… 


mmir 


图 1.1.8 调整 透明 度 


1.1.3 文件 夹 及 文件 比较 


用 户 可 以 使 用 MATLAB 文件 比较 工具 ,比较 两 个 文件 夹 下 属 文件 的 类 型 .文件 名 .大 小 、 
修改 时 间 ,以 及 两 个 具体 的 文本 文件 .MAT 文件 .二 进 制 文件 之 间 的 差异 。 

绿色 .红色 .无 色 . 蓝 色 分 别 表示 右 侧 文 件 夹 与 左 侧 文 件 夹 的 比较 结果 :增加 、 修 改 、 一 致 、 
删除 。 单 击 工具 栏 的 按钮 寻 ,可 以 调换 两 个 文件 夹 位 置 , 如 图 1.1. 9 所 示 。 


2 





二 SA 
日 tw Semgwmon Dabwg Damttep Mndon He 站 
和 Se 
comparing folder mprogram VS5。folder mscript 8 
民 ， 
月 [Teee 行 le list Contents of folder 6:VIATLABWbhookWnprogran 人 
| Rieht 有 le 村 


和 TPm Contents of folder G:IVIATLABSVboock Vscript 
所 上 Im header 1 or 1 te 加 
In left liet 《folder Jm right lint 【folder 
本 CC 工人 
Si ze  Lmst Eodifiecd Size Last iodi 和 ed 
(by+es) 


Type 1 jinme (bytes) Beta 


7TC 全 je ruieu 三 E (open) 
Ele | LTLe (open: la 人 al zisht) | 590 
和 一 下 -cn 二 warrriihoqysc 于 -vs 
lw 

= -= 林 


meu_acript- 相 【open: [zit| 
)》 


renDecrmoe em 





图 1.1.9 比较 结果 
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单 击 Type、File Name、Size、Last Modified Date .Change Summary 等 栏目 名 ,可 调整 表格 
的 排序 方式 (如 图 1.1. 9 按 比较 结果 排序 ) 。 

单 击 链接 left 或 right, 可 以 打开 左 侧 或 右 侧 文 件 夹 的 对 应 文件 , 若 同 时 打开 了 两 个 文件 ， 
用 户 还 可 以 将 MATLAB 编辑 器 窗口 调整 为 纵向 并 列 , 具 体 分 析 文 件 的 差异 如 图 1. 1. 10 


所 示 。 
File dt It Go Sell To Debug Desitop 忒 indow Help 忆 
二 本 二 作 避风 -有 交 温和 全 
[ 骨 屿 彰 唱 坦 ] -10 二 :4134 





1 一 Clear 1 一 clear 
2 一 cla: 2 一 clec: 

3 -~ Loadf LIITI.mst ) :; “3 外 oadt LI 订 .aa3t”) 

一 = randif10) 要 一 y = randit3J0001 ; 

5 一 1esapyear(ty) : 5 一 leapyearlt7y) 


|eapyear_script 和 有 X )feapyeafr scriptm 藉 


Script tn 5 Col 1 


图 1.1.10 并 列 MATLAE 编辑 器 窗口 


显然 人 工 比 较 容 易 出 错 , 用 户 可 继续 单 击 图 1. 1. 9 表格 最 后 一 列 的 链接 compare, 自动 比 
较 文件 差异 ,如 图 1.1.11 所 示 。 


file dt Debug Dexsktop Window Help 汪 本 洋 
二 人 已 媳 开机 动 | columnsvisible 4 CC 7) 田 旧 日 亲口 
1955cCottWy DocumentsMATLAE\WDoompro0rameapyear scriptm 性 jings\scaottMy DocumentsVVWIATLAB\bookvnscriptMieapyear scriptm 
1eapYear _ Script- 如 Leapyear_Script. 加 
C:VDocuments and SettingsVscott\Wy Ci\Documents and SettingsVscottAVy 


DocumentsWNATLABN\book\mprogram DocumentsNWATLAB\bookN\mscript 
07- 四 月 -2010 23:52:48 07- 四 月 -2010 23:52:51 


1 differences found，Use the toolbar buttons to navigate to them. 


1 clear; 。Clear; 1 

2 守信 。 和 Le 2 
_3y=zrandi(10); 《 
_ 4 leapyear(y) ; 《 

_5 load( LTI. mat ); x load( LTI.mat” ) _3 

>y = randi(3000) ; _ 

> leapyear (y) ; 8 


Number of matching lines: 2 


Number of unmatched lines in left-~hand file: 3 


Number of unmatched lines in right-~hand file: 3 


了 program vs, mscript Xieapyear script,m YS- ieap,，X 


图 1.1.11 自动 比较 文件 差异 
MATLAB 7. 10 的 文件 比较 器 新 增 了 高 亮 功 能 ,两 个 文件 之 间 存 在 差异 的 行将 被 高 亮 显 
示 , 同 时 在 工具 栏 新 增 了 按钮 | 二 | 人 ,便于 逐一 比较 各 个 差异 。 


”二 硬 夸 活 
. 
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1.1.4 登录 MATLAB 文件 交换 服务 器 


在 MATLAB 环境 中 ,用 户 可 轻松 地 登录 MATLAB File Exchange 服务 器 ,享受 MAT- 
LAB 文件 交换 服务 。 即 用 户 可 以 使 用 由 MathWorks 公司 或 世界 各 地 用 户 上 传 至 Math- 
Works 服务 器 的 各 种 MATLAB 程序 、 Simulink 模型 .演示 视频 等 。 合 理 有 效 地 利用 这 些 文 
件 , 可 节省 用 户 的 学 习 与 开发 时 间 .启发 思路 .扩展 视野 。 

使 用 该 项 服务 是 免费 的 ,不 过 用 户 需 要 拥有 MathWorks 账户 并 能 够 访问 互联 网 ,当然 建 
立 账户 也 是 免费 的 。 

单 击 MATLAB 主 窗 口 菜单 项 Desktop -一 File Exchange, 打 开 登 录 界 面 , 如 图 1. 1.12 所 示 。 


Rie Desktop 区 imdow Help 


My MathWorks Account 


E-mailaddre5s: Dom't have an 3CCDUOE 
Pascswor 帮 
Rate and Comment on fies 


VEwW and report bu93 
了 Rermember me submg | Recewe ine MATLAE Digest 


Download pfoduct tnas and manage Icerses 


P oOt eur oasswaora 
诊 Qf2Qt OUr 及 85 页 


FNes dowrWoasded fo Ihe Fiie ExrchanDe Wihiie inaTLAB are iicen5ed omnder ie 5landard terms Cf he BSD Icense 
an notf The hfathiVorks Inc Socofware Licen5e Agreemert 


图 1.1.12 用 户 登 录 


用 户 可 以 单 击 链接 Creat an account 创建 一 个 Mathworks 账户 ,或 使 用 已 创建 的 账户 登 
录 MATLAB File Exchange 服务 器 ,如 图 1. 1. 13 所 示 。 


Fe Beskiop windcow Help 条 
和 办 Logged in ac XXX | Domnonn Maion | Lo Du li 可 
态 昌 | Ta9 View 办 | 
Wew ia05 a5 LE | Ce 
annotalion ”chemilsty data export data import example graphics gui 9uiioos 
image processing _mathematics “optimization ”physics pol potng probability 
signal processing “simulation ”simulink ”specaized statistics Utilities 


寻 Tags 
~ Submitted Fie Summary Tags Rating Dowmload; 生 
Testerdayy 写 ~ Tooclnp Waiban oO8S wsk04 全 而 
输 Dospiayy toofpP 5ired waab 
AUEmeor CeOffrey Aiem 50 2 ratmng9s 
Teiterday 硼 fprary sd30 me hure 0 handie DJ 22 光 
Uerary of urer interface fumd 时 
ARPor Peteyr DO Comnmor 
Texterday SirmpecC okorDelectorm CE CSi0/ -全 35ICSS0n COiCY Getecopr 3 加 每 
三 SS To do VD 60 dete 
共和 ， senor mage Araytt 5 1 mbnga 
Yesterday IFmogfwodewC bo0eSsn 本 nonotonc True -aoe 109 屋 
Derermnes whnether ef rrot 3 . 
Autor Ricyif Coion 50 ,2 fbnmgs 
Testerday MEANRT VII SMWULATOR SU_ bech mgtnemaccs 5 MMDSSA9 2 6 
heart VD youlateor iuiimk Sr 
1 -30 et5433 resol 嘻 1;2 3 4 :5 


图 1.1.13 MATLAB File Exchange 主页 


基于 模型 的 设计 一 一 MCU 篇 


在 搜索 栏 输入 关键 词 , 例 如 BER ,打开 任意 一 个 搜索 结果 , 单 击 左上 角 Download 按钮 右 
侧 的 下 稍 头 , 可 以 选择 下 载 到 默认 目录 、 当 前 目录 或 任意 目录 ,如 图 1. 1. 14 所 示 。 


BER of BPSK in AWGN Channel 


RAT 
电 Download| 中 View More File Detall5 
人 } 





Downloadto DeftauU 让 Folder ,,，. 
by Chandra Aniruddha 
十 一 -23-2009 Updated 十 一 月 -23-2009) 
Daownioad tao ,,， Rate 细 语 人 


Thnis program smulates BER of BPSK Over AWGN channel and 


176 downioads (flast 30 days 
compares with theoretical rate 汉 ) 


Fale Size 1.72 KB 


Fie ID: 25922 


图 1.1.14 下 载 页 面 


与 R2009b 不 同 的 是 ,由 于 R2010a 增加 了 解压 缩 功能 ,下 载 的 文件 将 自动 解压 缩 到 当前 
目录 ,不 再 是 单独 的 ZIP 文件 。 


1.2 M 文件 的 编写 


MATLAB 有 两 种 形式 的 M 文件 :M 琐 数 文件 与 M 脚本 文件 。 编 写 M 文件 的 好 处 在 于 
用 户 可 以 将 需要 执行 的 一 系列 MATLAB 指令 包含 在 一 个 文件 里 , 而 在 命令 行 窗 口 用 户 只 需 
要 输入 一 条 执行 该 文件 的 指令 。 

完整 的 M 文件 应 包含 以 下 各 部 分 ,当然 其 中 的 函数 定义 行 只 用 于 M 函数 文件 。 


【 例 1. 2. 1】 

function Y = fact(x) $% 函数 定义 行 

多 Compute a factorial value. 向 日 1 行 

币 FARCT(Xx) returns the factorial of x， 负 帮助 

先 USually denoted by xfl 

向 Put SimplyY，EFRCT(x) is PROD(1:x). 委 注 释 

Y = prod(1:x)， #% 函数 体 / 脚 本 体 


1.2.1 NM 文件 结构 


1. 函数 定义 行 
郴 数 定 义 行 必须 在 M 困 数 文件 第 一 行 , 它 定 义 了 函数 的 名 称 以 及 输入 /输出 参数 的 数量 
和 顺序 。 
如 例 1. 2. 1,function 是 关键 字 ,y 是 输出 参数 ,fact 是 函数 名 ,x 是 输入 参数 。 
对 于 多 输入 /输出 的 情况 ,将 输出 参数 放 人 方 括 弧 [ ], 输 入 参数 放 和 人 圆 括 弧 (), 参 数 之 间 
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用 半角 逗号 区 隔 , 如 function [x，y，z]j] = func(a，b，c) 。 

若 函 数 没有 输出 ,可 将 输出 留 空 或 使 用 一 对 空 的 方 括 弧 。 如 function printresults(x) 或 
function[L ] 王 printresults(x) 。 

果 数 名 必须 以 字母 开始 ,此 后 可 以 包含 任何 字母 .数字 或 下 画 线 。 文 件 名 长 度 不 能 超过 最 
大 人 允许 长 度 凡 。 虽 然 理 论 上 M 函数 名 可 以 是 任意 长 度 的 ,但 MATLAB 仅 截 取 前 N 个 字符 
作为 函数 名 ,因此 用 户 需 要 确保 该 数 名 是 唯一 的 。 使 用 namelengthmax 可 以 查看 允许 的 最 
大 文件 名 长 度 。 

MATLAB 系统 有 一 些 保留 字 , 用 户 不 能 使 用 它们 作为 函数 名 ,使 用 isvarname 命令 检查 
某 个 晒 数 名 是 否 合法 ,如 isvarname myfun。 返 回 值 为 1 表示 可 用 ,返回 值 为 0 表示 不 可 用 。 

M 盟 数 的 郴 数 名 一 般 也 是 该 M 图 数 文件 的 文件 名 ,如 果 二 者 不 一 致 ,M 文件 里 的 函数 名 
将 被 忽略 ,用 户 应 该 使 用 M 函数 文件 的 文件 名 来 调用 该 晒 数 。 

例如 某 函 数 文件 名 为 average. m, 而 文件 内 的 郴 数 命名 为 computeAverage, 则 用 户 应 该 
使 用 average 来 调用 该 函数 。 为 避免 混乱 ,通常 应 统一 这 两 个 名 称 。 


2。 HI 行 


M 文件 的 简单 描述 以 中 开始 。 如 例 1. 2. 1:% Compute a factorial value。 

当 用 户 在 MATLAB 命令 窗口 输入 help functionname 时 ,Hl 行将 在 帮助 信息 的 第 一 行 
显示 。 若 使 用 ljookfor 命令 查询 , 则 仅 显 示 该 H1 行 。 因 此 用 户 在 编写 H1 行 时 必须 简明 
扼要 。 

3. 帮 助 

用 户 可 以 为 自己 编写 的 M 文件 增加 一 些 联机 帮助 信息 ,这 些 信 息 可 以 是 一 行 , 也 可 连续 
多 行 的 。MATLAB 系统 认为 紧 随 HI1 行 后 ,一 组 连续 以 只 开始 的 文字 即 该 函数 的 联机 帮助 信 
息 ,一 旦 中 断 , 即 认为 帮助 信息 结束 。 即 使 此 后 还 有 注释 行 ,它们 也 将 被 忽略 。 

注意 :用 户 M 文件 里 的 帮助 信息 只 能 在 MATLAB 命令 行 窗 口 显示 ,在 MATLAB 帮助 
浏览 器 中 是 看 不 到 的 。 帮 助 浏览 器 只 能 用 来 查看 MathWorks 公司 系列 产品 的 帮助 信息 。 


4. 注释 


注释 文本 以 为 开始 , 它 可 以 插 在 M 文件 的 任何 位 置 , 包 括 某 一 行 代码 的 后 面 。 另 外 用 户 
可 以 在 M 文件 的 任意 位 置 加 入 空 行 。 尽 管 空 行将 被 忽略 ,不 过 它 可 以 用 来 结束 帮助 信息 。 

有 时 需要 分 行 显示 的 注释 ,虽然 可 以 在 每 行 之 前 分 别 加 上 %% ,比较 简便 的 方法 是 使 用 块 注 
释 标 记 %{ 和 %} 。 这 两 个 符号 必须 独立 占用 一 行 , 符 号 与 注释 行 间 不 能 有 空 行 ,如 ; 

| 

This next block of code checks the number of inputs 

passed in，makes Sure that each input is a valid data 





一 -一 一 ------ 一 一 -一 一 一 - -一 - 


type，and then branches to start processing the data， 
种 } 


5s. 函数 体 / 脚 本 体 


函数 体 / 脚 本 体 可 以 包括 函数 调用 .变量 赋值 .计算 式 、. 注 释 、 空 行 . 以 及 程序 结构 体 , 如 流 
控制 和 交互 输入 /输出 。 
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【 例 1. 2. 2】〗 计算 一 组 数值 的 平均 值 


[m,n] = size(x); $% 数组 维度 

主 ( 一 ma || (= 一 155n==1)) *# 流 控制 
error( Input must be a vector ); #% 错误 提示 

end 

Y = Sum(x)/1Length(x) ; g% 平均 值 计 算 


1.2.2 M 脚本 文件 


脚本 文件 是 最 简单 的 M 文件 , 它 不 需要 输入 参数 ,同时 也 不 返回 输出 ,常用 于 执行 那些 需 
要 多 次 执行 的 指令 。 

脚本 文件 使 用 MATLAB 的 基本 工作 空间 ,可 对 已 有 的 变量 进行 操作 或 者 新 建 变量 。 脚 
本 文件 执行 完毕 ,所 有 变量 都 将 保留 在 基本 工作 空间 , 供 后 续 使 用 。 在 命令 行 窗口 输入 whos， 
可 以 查看 这 些 变量 。 

显然 ,运行 了 脚本 文件 ,此 前 保存 在 基本 工作 空间 的 同名 变量 都 将 被 加 盖 。 

【 例 1.2. 3】 二 阶 网 络 的 冲 激 响应 与 阶 妈 响 应 

二 阶 RCL 网 络 如 图 1. 2. 1 所 示 ,其 中 尺 = 200Q 人 =10 H 、C 王 3000 nF。 





图 1.2.1 二 阶 RCL 网 络 


根据 基 尔 元 夫 电流 定 律 ,有 : 。 xw(2) 一 工 旦 十 Ri 十 
] 


其 中 电容 两 端的 电压 为 : uke 一 巨 id 

两 式 各 取 拉 普 拉 斯 变换 ,整理 得 : U() 一 (LCs: 十 RRCs 十 1)U. (Cs) 
_UD_ 1 _- 1 

传递 函数 为 : ”五 G) 一 并 CSJ 一 TCFTRCSHI 一 3 二 605 干 100 

为 得 到 该 二 阶 网 络 的 冲 激 员 应 与 阶 跃 响应 ,编写 脚本 如 下 : 

ClLeari 

Clc 

num = 100; g% 定义 分 子 

den = [3,60,100]; 外 定义 分 母 

h = tft(num,den); % 建立 状态 方程 

s = ss(h); $ 转化 到 状态 空间 

[yiy,tiyxi]= impulse(s); $ 单位 冲 激 响应 

[ys,ts,xs] = step(s); $ 单位 阶 茎 响应 


plot(Ctiyvyiy 一 xD); 


: “0，。 -一 一 苹 
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hold on 

plot(ts,yYSs，- 一 工 )j 

hold off; 

xlabel(t7); # X 轴 标 签 
ylabel(CU_c(t)) % 了 轴 标签 

axis([04 -0.51.5]); % 设置 X,Y 轴 数 据 显示 范围 
grid on; $ 显示 坐标 网 格 

h = legend(' impulse',' step',1); Y% 图 例句 柄 
set(h,， Interpreter ' none)); * 显示 图 例 


保存 上 述 代码 并 运行 ,结果 显示 如 图 1. 2. 2 所 示 。 





图 1.2.2 二 阶 RCL 网 络 响应 
对 于 简单 的 绘图 ,用 户 不 必 编 写 M 脚本 或 在 命令 行 窗 口 逐 一 输入 代码 ,使 用 MATLAB 
工作 空间 浏览 器 上 方 的 软 seeasaetpet 绘图 按钮 ,可 快速 得 到 需要 的 图 形 。 
设 上 例 的 变量 已 存在 于 工作 空间 , 则 依次 选中 变量 ti\yi, 如 图 1. 2. 3 所 示 。 





Eile Edit View Graphics _ Debug Desktop Window 半 eip， 下 
ja 划 ] 让 到 Stacic|i 6ase Fw piotttiyi 四 
Name 和 Value Min Max 

要 <1346xd double> 0 3.8842 
田 * <115xd double> 0 2.9951 

基 <1346Xx2 doublie> -01207 2 

5 < 夺 SNX2 doublie> 0 0D.4778 
转 ? <1346xd4 double> 0 1.4183 

中 <1l5xl double> 0 0.9954 


图 1.2.3 选中 变量 


(1) 按 窗口 右上 方 的 加 werem_ 按钮 , 即 可 得 到 与 图 1. 2. 2 一 致 的 结果 。 同 时 在 命 
令 行 窗口 显示 对 应 的 绘图 代码 ,用户 可 将 此 作为 后 期 编程 的 参考 。 


>> plot(tiyyi，DisplayName '", ti vs， Yi"，XDataSource", ti"，YDataSource',' yi 7);figure(gcf) 


“1 1 
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(2) 按 绘图 按钮 右 侧 的 下 拉 箭 头 , 可 以 得 到 更 多 的 绘图 项 目 , 将 鼠标 指针 悬 停 在 某 绘图 项 


目 , 即 显示 该 项 目的 帮助 信息 ,如 图 1.2.4 所 示 。 


、。 
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Warsus Yector xn on the sarme axes ione 帮 Yn of 
3 mxXnisamatrix andthe other1s 3yVector,plots the 
心 在 属 vector versus the matrix Tow or column with 3 


时 malching dmension to the yeclokL JXn i 3 SCcalar 


一 


and TiS avectol plots discrae n points vartically 
mA 更 多 环 理 mveamamr-i~ wm np 


人 





图 1.2.4 项 目 帮 助 信息 


(3) 在 选择 绘图 变量 时 ,系统 默认 先 选 中 的 为 x, 后 选中 的 为 y,Mathworks R2009b 提供 
了 按钮 xcxz 允许 用 户 交 换 xy 变量 ,便于 重新 绘图 。 对 于 常用 的 项 目 , 用 户 可 以 按 下 注 ,将 其 
列 人 收藏 。 

(4) 右 击 某 一 绘图 项 目 , 如 图 1. 2. 5 所 示 ,选择 菜单 项 Insert to Command Windows 或 
Copy, 可 以 直接 将 该 绘图 的 命令 插 和 人 命令 行 窗口 或 粘贴 板 , 便 于 用 户 二 次 修改 。 





| Plots for 蕊 3 太 iE plots 

六 Favorites < 
| 厅 | anin xtzx 全 
| Execute 
| 呈 训 Insertto Command Window 入 
| MA 二 
-0Pp) Crj=C 女 


| | 
上 Remove Favorite | 
Restore Factory La3yout 
图 1.2.5 插入 命令 


1.2.3 快捷 方式 


用 户 可 以 使 用 M 脚本 批量 执行 一 组 M 代码 ,不 过 它 是 以 文件 形式 保存 的 ,因此 在 使 用 之 
前 必须 先 找到 该 文件 , 另 一 种 运行 常用 命令 的 方法 是 使 用 MATLAB 快捷 方式 ,其 功能 类 似 于 
M 脚本 ,但 它 并 不 以 文件 形式 保存 。 . 

(1) 单 击 MATLAB 主 窗口 菜单 项 Desktop 一 Toolbars-~>Shortcuts, 开 启 或 关闭 主 窗 口 的 
Shortcuts 工具 条 ,如 图 1. 2.6 所 示 。 

(2) 右 击 Shortcuts 工具 条 ,选择 New Shortcut 选项 ,如 图 1. 2.7 所 示 。 


* 。 12 让 
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ED 了 srahel 已 esktop 汪 IndON 所 < 
双人 部 中 三 人 Current Foldef 


Shortcuts 划 Howto hdd 列 What's New 


how kbels 


Foldet 办 局 时 New Shortcut 入 本 
和 mptogram 及 Organlze3hoOrteut; 
Pa De } ielp Or Shorteut 
网 P Name 
< 一 > 伏 品 = 办 ， w HATLAB Tepibar 
首 一 一 一 一 | Iapye3rm wY rcut5 TDib 
Shortcuts 下 Howto Add 如 Whats New “eapyear_5criptm asigstes 相 


图 1.2.6 快捷 方式 工具 条 图 1.2.7 新 建 快捷 方式 菜单 


按 图 1. 2. 8 所 示 的 编辑 窗口 进行 设置 并 保存 ,在 Shortcuts 工具 条 即 得 到 一 个 清空 命令 行 
窗口 的 快捷 方式 ,如 图 1. 2.9 所 示 。 


Labejl: cliear command 


Calliback GT， 


Categorr' Tooilbar Shortcuts 
Icon' 和 MATLAB icon v 


Saves Shortcutto Start buUtton. Selecting Toolbar 
Sheortcuts” ”category af5o 5aves to Shortcuts to0o0Ibar， 


josaaaumcea 1 党 Y 妨 荆 基 当 本 局 了 四: 力 com 


SavVe SCE 所 
CO Shotcuty 到 Howse sdd 到 Whats New ;要 dear cormmand 
1.2.8 设置 快捷 方式 图 1.2.9 新 建 快捷 方式 


(3) 用 户 也 可 以 在 命令 行 窗 口 、 命 令 历史 窗口 或 M 文件 窗口 ,选中 一 系列 代码 , 拖 人 
Shortcuts 工具 条 ,在 后 续 跳 出 的 编辑 窗口 ,输入 显示 标签 等 信息 ,建立 快捷 方式 ,如 图 1. 2. 10 
所 示 。 


Tesktep fD 站 ef 


可 思 ciDocumentsan * 


Shortcuts 旭 Howto Ada 到 Wpats New 我 clear command 





图 1.2.10 快速 新 建 快 捷 方 式 


1.2.4 M 函数 


M 函数 文件 可 接受 输入 参数 ,并 返回 输出 。 如 上 文 所 述 ,使 用 M 文件 定义 M 函数 ,该 文 
件 必 须 以 函数 定义 行 作为 起 始 行 , 或 以 end 为 结束 ,或 以 另 一 个 函数 的 定义 行 作为 上 一 个 函数 


“J3，。 ; 
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的 结束 。 但 如 果 用 户 在 一 个 函数 体内 定义 了 一 个 或 多 个 典 套 函数 , 则 必须 使 用 end 结束 某 散 
套 函 数 。 

每 个 M 函数 使 用 各 自 的 工作 空间 ,可 称 为 函数 工作 空间 ,独立 于 人 们 平常 通过 命令 行 或 
脚本 文件 访问 的 MATLAB 基本 工作 空间 。 

M 困 数 可 分 为 以 下 几 类 

(1) 主 函 数 (Primary M-File Functions) , 它 是 每 个 M 函数 文件 中 的 第 一 个 天 数 ,通常 它 
包含 的 是 主 程序 。 

(2) 子 函 数 (Subfunctions) ,M 琐 数 文件 可 以 包含 多 个 天 数 ,除了 主 枯 数 ,其 他 郴 数 即 称 
为 子 果 数 。 

(3) 艇 套现 数 (Nested Functions) , 它 定 义 在 另 一 个 函数 内 ,可 以 增加 枉 数 的 可 读 性 与 灵 
活性 。 

(4) 匿名 函数 (Anonymous Functions) ,一 种 可 快速 定义 的 函数 , 它 可 以 出 现在 另 一 个 郴 
数 内 ,更 重要 的 是 可 以 在 MATLAB 命令 行 定 义 匿 名 晒 数 。 

(5) 重 载 函 数 (Overloaded Functions) ,特别 适合 于 用 户 需 要 建立 一 个 输入 参数 能 够 接受 
不 同类 型 数据 的 函数 。 这 类 似 于 其 他 面向 对 象 语 言 中 的 重 载 函数 。 

(6) 私有 函数 (Private Functions) , 它 只 能 由 处 于 其 父 目 录 的 M 函数 访问 。 主 果 数 . 子 项 
数 . 认 套 函数 .私有 函数 之 间 的 区 别 仅仅 是 函数 的 地 位 ,函数 结构 没有 明显 不 同 , 众 多 文献 已 有 
详细 论述 ,本 文 不 再 理 述 。 

【 例 1.2.4】 国 年 函数 

根据 历法 ,公历 闭 年 精确 的 计算 方法 如 下 : 

(1) 普通 年 能 被 4 整除 的 为 闽 年 。 

(2) 世纪 年 能 被 100 整除 而 不 能 被 400 整除 的 不 是 头 年 。 

(3) 对 于 数值 很 大 的 年 份 能 整除 3200 ,但 同时 又 能 整除 172 800 的 是 国 年 。 

为 简化 说 明 过 程 , 本 函数 不 用 于 判断 数值 很 大 的 年 份 。 


function Str = leapyear( Y ) 


% 判断 一 个 年 份 是 否 为 头 年 


if rem(Y,4)== 0 $ 年 份 能 被 4 整除 
if rem(y,100)== 0 $% 是 否 足 收 100 年 
if rem(Y,400)==0 % 整 100 年 能 否 被 400 整除 
leap = 1; $ 整 400 年 ,是 头 年 
else 
leap= 0; s% 整 100 年 但 非 整 400 年 , 非 头 年 
end 
else 
leap = 1 #% 被 4 整除 但 非 整 100 年 ,是 半年 
end 
elSe 
leap = 0; s% 不 能 被 4 整除 , 非 国 年 


end 
%g% 输出 结果 


as 了。 
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if leap == 1 


str = strcat([num2str(Y) ,IS a leap year.]); 


$% 若 leap 为 真 ,输出 肯定 字符 串 


elSe 
str = strcat([num2str(Y) ,is NOT a leap year. ]); 
s% 若 leap 为 真 , 输 出 否定 字符 串 


end 
end 
在 MATLAB 命令 行 调用 该 郴 数 , 得 到 : 
>>Y = randi(3000) 
Y = 2725 


>> leapYear(Y) 
ans = 2725 15 NOT a leap Year. 


【 例 1.2.5】〗 使 用 Runge-Kutta 法 求解 一 阶 常 微分 方程 
一 阶 常 微分 方程 的 初 值 问题 表示 如 下 : 
人 xzE[a, 雪 


y(a) 一 yo 
只 要 (zy) 在 [a,b]XR: 上 连续 , 且 关 于 y 满足 利 普 希 茨 (Lipschitz) 条 件 , 则 上 述 问题 
存在 唯一 解 , 因 此 可 以 使 用 Runge-Kutta 算法 得 到 其 数值 解 。 
四 阶 Runge-Knutta 算法 表示 如 下 : 


.yn 二 1 一 光 十 个 十 2&， 十 255 十 有 ) 


Ri 一 大 (CZzoyyn) 
四 1 六 
已 一 了 (z 十 到 A,2 十 到 后) 


已 一 丰 ( ,十 喜 A2 十 到 要 
Ai 一 三 (Zu 十 尹 , yn 十 几 ps ) 
使 用 M 郴 数 实现 的 代码 如 下 : 
function Y = ruku(fxyxminyxmax,y0) 
s% 采用 四 阶 龙 格 库 塔 法 数值 积分 
% fx 为 也 数 名 


$% x0 为 自 变 基 的 初始 值 
# Y0 为 因 变 量 的 初始 值 


h = 0.01; $% 步 长 

Xx = xmin:hyxmax; % 自 变 最 

n = length(x); #% 计算 点 数 

Y = zeros(1:n); $ 初始 化 了 向 量 
Y(1) = Y0; ss 了 初 值 


#$ $ 四 阶 龙 格 库 塔 法 
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for 革 = 1:n 
kl = feval(fx,x(Ci),Yy(Ci)); 
第 贡 K2 


X_temp = X(i) + h/2; 

Y_temp = Y(i) +kl x h/2; 

k2 = feval(fx,x_temp,y_temp) ; 
向 凶 K3 

x_temp = X(i) + h/2; 


Y_ temp = Y(Ci) +X2x h/2; 
k3 = feval(fx,x_temp,Y_ temp); 
第 革 K4 
Xx_temp = X(i) +h/2; 
Y_temp = Y(i) +k3# h/2; 
k4 = feval(fx,x temp,y temp); 
币 委 YYCR+1) 
Y(i+1l) = Y(Ci)+(kl+2#k2+2xk3+k4)xh/6i 
end 
$% $ 绘图 
Y = YC1:n); 
PJot(xY); 
title('4 order Runge - Kutta ) ; 
xlabel(x)7); #% X 轴 标 签 
ylabel(Yy7); #g Y 轴 标 签 
grid onj; 
end 


在 MATLAB 命令 行 调用 该 函数 ,运行 结果 如 图 1. 2. 11 所 示 。 


>> fx = 四 (xy) X2 一 Yi 
>> ruku(fx, 一 3,3,2); 





图 1.2.11 一 阶 常 微分 方程 数值 解 
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1.2.5 匿名 函数 


例 1. 2. 5 使 用 到 了 匿名 函数 fx = @(x,y) x 2 一 yY。 这 是 一 种 简单 的 M 函数 ,不 需要 为 
它 创 建 M 文件 ,可 以 在 命令 行 窗口 直接 定义 ,也 可 以 在 M 函数 文件 或 脚本 文件 里 定义 。 

建立 匿名 函数 的 指令 是 :fhandle = @(arglist) expr 

其 中 expr 表示 函数 体 , 它 可 以 是 任意 的 单一 合法 的 MATLAB 表达 式 ;arglist 表示 输入 
参数 (多 个 参数 可 用 半角 逗号 区 隔 )。 这 两 者 与 其 他 M 函数 没有 区 别 。 

操作 符 @ 的 作用 是 建立 一 个 函数 句柄 ,用 户 可 以 使 用 句柄 调用 对 应 的 匿名 苯 数 。 此 后 利 
用 指令 fhandle(argl，arg2,，...，argN) 即 可 运行 该 函数 ,得 到 对 应 的 输出 。 

定义 一 个 芽 名 顺 数 ,操作 符 @ 是 必 不 可 少 的 。 

值得 注意 的 是 ,函数 句柄 不 仅仅 用 于 访问 匿名 基 数 .用 户 也 可 以 对 任意 的 MATLAB 顶 数 
定义 句柄 。 不 过 指令 格式 有 所 不 同 :fhandle 王 @functionname (如 fhandle 王 @sin) 。 

【 例 1. 2.6】 单 输入 匿名 函数 

下 面 的 指令 建立 了 一 个 计算 二 次 方 的 匿名 函数 ， 


>> sqr = 四 (x) x2; 
sqr 即 这 个 匿名 函数 的 句柄 ,可 以 这 样 计算 一 个 数 的 平方 : 


>>a = Sqr(5) 
引 = 25 


【 例 1. 2.7】〗 双 输 入 匿名 隔 数 

下 面 的 指令 建立 了 一 个 二 元 函数 

>> Sumxy = @(x，VY) (2*#X 二 3xY); 

取 x 一 3,y 一 4, 计 算 该 二 元 函数 值 ; 


>>Cc = Sumxy(3，4) 
C = 18 


1.2.6 了 涛 数 提示 


1. 函数 名 提示 
MATLAB 7. 10 新 增 了 郴 数 提示 功能 , 若 用 户 仅 依 稀 记 得 某 蚂 数 的 起 始 字母 ,可 以 在 输入 这 
些 字母 后 按 Tab 键 ,系统 自动 列 出 以 这 些 字 母 开 始 的 所 有 函 数 , 供 用户 选 择 ,如 图 1. 2. 12 所 示 。 
2. 参数 提示 


用 户 若 事先 已 输入 某 一 函数 的 函数 名 ,但 不 确定 该 函数 的 输入 参数 , 则 在 函数 名 后 加 上 一 
个 左 圆 括 弧 , 稍 等 片刻 ,系统 即 显示 该 函数 的 各 种 可 能 的 表达 式 格 式 , 如 图 1. 2.13 所 示 
提示 框 的 内 容 将 根据 用 户 后 续 的 输入 不 断 筛 选 显 示 , 如 图 1. 2. 14 所 示 。 


若 s 到 : 区 ; 


本 > 基于 模型 的 设计 一 一 MCU 篇 


单 击 提示 框 下 部 的 链接 More Help. . . ,可 链接 到 帮助 文档 ,如 图 1. 2.15 所 示 。 


Pile Edit| fftshift vsndow Help 


谋 人 证 





图 1.2.12 函数 名 提示 


File 三 dt Debug Desktop Wimdow Heip 3 
和 虽 作 | 马 | 的 
En There are otherfunctions or methods named ft 


挫 


Discrete Fourier transform 


Eft 代 ) 
Etft (mn) 


EEt 从，[], dm) 

EEt (IE nm dim) 

FEft(gE sject.  .) 
More Help..， 





下 t (和 X) 

于 和 tL (和 了 ) 

EEt (Xdaim) 
EEt (X ny azm) 


图 1.2.13 函数 参数 提示 


习 
了 
工 
芝 


Pile Edit Debug Desktop indow He 3 Definition 


友 >》 fft ta, b， The functions Y=EEt (x) and 
FE yY=ittft (X) implementthe transform 
人 and inverse transform pair givenfor 
Ett 供 , mn dim) Vectors of length N by- 


站 上 





More Help... 


Qeen Hgis arsvrz4 有 1099e focu5 Escape 1o Gose 





图 1.2.14 参数 筛选 显示 图 1.2.15 函数 帮助 
1.3 M 文件 的 调试 


1.3.1 M-Lint 
MATLAB ?7. 2 增加 了 M-Lint 代码 检查 器 ,或 直接 称 作 M-Lint, 可 以 检查 用 户 代 码 中 存 


在 的 问题 ,并 提出 推荐 的 修改 方法 ,使 之 性 能 与 可 靠 性 达到 最 大 。MATLAB 7. 10 将 M-Lint 
称 作 Code Analyzer, 但 函数 mlint 与 mlintrpt 依然 保持 原名 。 
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用 户 可 以 在 代码 编辑 过 程 中 ,根据 M-Lint 自动 更 新 的 提示 信息 ,随时 修改 对 应 的 代码 。 
对 于 某 些 提示 ,M-Lint 还 提供 了 额外 的 信息 ,或 者 自动 修改 功能 ,或 者 两 者 名 有 。 实 时 代码 检 
查 与 修改 界面 的 使 用 将 在 第 1. 5 节 Embedded MATLAB 中 介绍 。 


1.3.2 使 用 cells 加 快 调 试 


M 文件 通常 是 由 几 个 功能 代码 区 组 成 的 ,对 于 一 个 很 长 的 M 文 件 , 在 某 个 时 候 用 户 只 专 
注 于 调试 某 个 代码 区 。 自 MathWorks R14 起 ,用 户 可 以 使 用 cell 模式 加 快 M 文件 的 调试 。 
字面 理解 ,cell 就 是 表示 某 个 代码 区 ,每 个 cell 包含 了 若干 行 代码 ,用 户 可 以 将 这 些 代 码 看 作 
一 个 M 脚本 ,对 其 进行 单独 调试 。 另 外 ,定义 了 cell 的 M 文件 ,其 发 布 的 文档 更 具有 可 读 性 。 
cell 模式 仅 用 于 常规 M 文件 ,不 适用 于 Embedded MATLAB 与 其 他 TXT 文档 。 


1. 定义 cell 
cell 是 M 文件 里 的 一 段 代 码 , 因 此 必须 定义 它 的 边界 :这 种 边界 分 为 用 户 定义 的 显 性 边 
界 与 MATLAB 默认 的 隐 性 边界 。 
定义 显 性 边界 的 一 般 方 法 是 在 cell 的 开始 插入 一 个 空 行 ,并 输入 两 个 连续 的 百 分 号 
“%%%%”( 图 1.3.1 行 1), 称 作 显 性 cell 边界 符 。 当 然 边界 符 也 可 以 捅 在 该 cell 的 第 一 行 代 码 
前 ,用 空格 与 后 面 的 代码 隔 开 ,但 是 显 性 边界 符 后 的 代码 将 被 视 为 cell 标题 ,不 再 是 可 执行 的 
代码 (图 1.3.1 行 11)。 


1 %s% 变 重 定义 





2 -- clear; 
3 -- clc : 

4 一 nunm = 100: % 定义 分 于 

5 - den = [3, 60, 100] : % 定义 分 母 
6 一 h = tf(num den) : 光 建立 状态 方程 
7 - s = ssth): % 转化 到 枯 态 空间 
8 吉 计算 用 应 
| 一 [fyi,ti,xi]=impulsefs); % 单位 冲冲 上 响 应 
150-= [ys, ts, xs]=step{fs) : % 单位 防 跃 响应 

11 %% 绘图 plot (ti, yi -KK ) 

12 ~ hold on; 
| 13 - plot (ts,ys, --r” ) : 


图 1.3.1 显 性 边界 


M 文件 的 开始 与 结尾 视 为 隐 性 cell 边界 。 对 于 M 函 数 文件 ,函数 声明 行 与 对 应 的 end 指 
令 也 作为 隐 性 边界 。 如 图 1. 3. 2 所 示 的 函数 ,由 于 插 人 显 性 cell 边界 符 ,function str 一 leap- 
year(x) 内 的 代码 被 视 为 两 个 cell。 

如 果 M 文件 .M 郴 数 体 或 控制 流 语 句 里 没有 显 性 边界 符 , 整 个 文件 或 琐 数 体 将 被 视 为 一 
个 cell, 这 样 的 cell 不 会 被 高 亮 显示 。 另 外 由 于 存在 隐 人 性 cell 边界 ,用 户 可 以 不 必 明 确定 义 第 
一 个 cell 的 起 始 位 置 , 如 图 1. 3. 2 所 示 。 


习 ”基于 模型 的 设计 一 MCU 篇 


| functlion 5tr = 1e3pyeari 了 
了 | 


上 | | 
委 2 
《全 
二 


1 一 广 1esp==1 


str = 台 TCt1[nun2strit)， 开 


慌 -~ str = strcatt [nun2strity)， 15 T a Jeap 25，]7 
ah 
end 


图 1.3.2 隐 性 边界 


2.。 删除 cell 
(1) 删除 cell 边界 符 所 在 的 整 行 。 


(2) 删除 cell 边界 符 其 中 的 一 个 百 分 号 。 
(3) 删除 cell 边界 符 与 cell 标题 之 间 的 空格 。 


3. 使 用 cell 调试 模式 

考察 例 1. 2. 3 二 阶 网 络 脚本 ,可 以 将 其 划分 为 3 个 cell: 首 先是 变量 定义 ,其 次 是 计算 响 
应 ,最 后 则 是 绘图 代码 。 

(1) 查看 MATLAB 编辑 器 Cell 菜单 项 下 的 第 一 个 选项 Enable Cell Mode/ Disable Cell 
Mode, 确 保 cell 调试 模式 已 启用 。 

(2) 将 光标 依次 定位 在 行 1“clear;” 行 6“[yi,ti,xi] 一 impulse(s);”、 行 %plot(ti,yi,-k 7);2” 的 
代码 之 前 ,并 单 击 编辑 器 窗口 工具 栏 按钮 咳 ,创建 3 个 cell, 当 前 的 cell 将 高 亮 显示 ,如 图 1. 3. 3 
所 示 。 

(3) 对 于 大 型 的 M 文件 ,建议 为 每 个 cell 添加 标题 ,方便 快速 定位 , 单 击 工具 栏 按钮 呆 , 显 
示 各 cell 的 标题 ,如 图 1. 3.4 所 示 。 

(4) 选择 cell 工具 栏 “变量 定义 ”命令 , 按 下 两 次 唱 按 钮 ,观察 工作 空间 的 变量 值 是 否 符合 
预期 ,在 初步 认定 代码 正确 的 情况 下 ,再 按 按钮 意 , 最 后 执行 cej 绘 图 "命令 。 

这 样 就 避免 了 在 尚未 明确 代码 是 否 正确 时 ,重复 执行 绘图 等 代码 ,加 快 了 M 文件 的 调试 。 

(5) 按钮 唱 . 旨 、 恒 用 于 直接 进入 下 一 个 或 上 - :个 cell 以 及 执行 整个 M 文件 ,默认 情况 下 
这 3 个 按钮 不 显示 在 编辑 窗口 ,用户 可 选 掺 cell 工具 栏 的 右键 菜单 项 Customize. . . ,在 打开 的 
选项 窗口 中 启用 这 三 个 按钮 ,如 图 1. 3. 5 所 示 。 


: 20 。 弦 
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Fe gd IJert Go Sol T2oks Debug Desdop Window Hep 时 Fe Ed It Go Sol Taos Debug -Desktop Window Hep 
站 局 易 关 二 要 7rmie- 机 和 办 几 四- 目 章 习 ] 可 大 ;基本 呀 六 人 可 的 和 哮 甩 | 到 -站 油 
加 喝 ! 上 -10 +;] al xx X% | 业 境遇 -hi vizhi xi 本 弥生 
! 3% 这 恒定 义 1 ! %% 芝 儿 定义 变 最 定义 
| 地 -- Cl1ear [insert cel byeak] 2 ~ clear 计算 响应 
| 3 elc _ 3 = clc 性 赂 
ITWEN 二 100 : 5 从 光 分 子 才 一 pwa = 100 % 诗 闵 入 - 
ES 一 den = 【3 60 100] 有 定义 分 马 Ss - dan = 13,. 50, 100] 革 征 与 
丰 一 h = tnum den) 过 立 该 态 方 牧 下 ~ h = flImum, den) % 建立 试 查 方 竹 
? 条 = 5 有) % 转化 双核 要 空 恕 3? 一 s = 33 小 ) # 转化 守 拓 者 安 商 
3 攻 半 计 茜 味 应 S W% 计算 哆 应 
全 一 [yi,tixi)=iagpulsefsi- S 熏 位 冲 者 咯 应 妆 一 [yi,ti,xij=xnpulseksy 各 匠人 市 扫 吕 遍 
如 ~ [ys,tsy xsj=step1s)} s% 喜人 位 际 玫 内 应 证 一 [ys, TYSs，XES]=step1s) % 要 位 耻 半 克 上 应 
b %% 绽 合 地 %5 经 二 
这 ~ Flot il yi， ) 钱 plot ta.yli， -上 】 


1.3.3 创建 cell 


图 1.3.4 命名 cell 
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~ ”Decrement value near cursyor snd evakuste celi (CirvNumpad -) 
Addj/Subtract Value 
二 “jnmcfement value near cursor and evaiate celi (Ciri<Mumpad +) 
中 Denidevakoe near cusor and evaluate cell (CtrleNumpad 由 
Muhply/Dmvvde vaue 
Miuanply valuwe near CUrror and evsaluate Ce (CtrlNurmnpad 1?) 
nsert cell bresk 
Show cc 中 ales 
Show Ce 晤 Mode information 


辐 本 国 匹 局 太 同和 龟 外 本 本 塌 扰 


局 六 站 x 


图 1.3.5 启用 cell 按钮 


蕊 


有 些 时 候 , 用 户 需 要 在 个 人 博客 会议、 项 目 组 上 公开 自己 完成 的 M 代码 及 结果 。MAT- 
LAB 为 此 提供 了 代码 发 布 工 具 , 它 将 用 户 代码 及 其 运行 全 过 程 以 HTML、LaTeX .doc、.PPT 
等 格式 (了 R2009b 还 新 增 了 PDF 格式 ) 形 成 一 份 完整 的 文件 ,便于 直接 使 用 或 二 次 编辑 。 


发 布 M 代码 的 方法 有 两 种 : 


(1) 在 编辑 窗口 选择 菜单 项 File~>Publish xxx 或 按钮 洁 , 使 用 默认 配置 发 布 M 代码 ; 

(2) 在 编辑 窗口 选择 菜单 项 File 一 Publish Configuration for xxx. m 一 Edit Publish 
Configuration for xxx. m. .. (图 1.4.1) 或 按钮 ; 沁 右 侧 的 下 拉 箭 头 H-> Edit Publish Configura- 
tion for xxx. m. . . ,修改 配置 选项 后 再 行 发 布 , 如 图 1. 4. 2 所 示 。 

方法 (1) 一 般 用 于 直接 发 布 M 脚本 文件 ,而 发 布 M 函数 文件 通常 需要 定义 输入 变量 , 因 
此 第 一 次 发 布 M 郴 数 需 要 使 用 方法 (2) ,此 后 则 可 使 用 方法 (1) 再 次 发 布 。 

以 例 1. 2. 5 代码 ,说 明 发 布 的 过 程 


醒 : 基于 模型 的 设计 一 一 MCU 篇 


力量 sa Im Go ”Gel Taok Debug Parallel Desktop Window “Heip 


》 局 | Current Folder， GANMATLABVbookmprogram 四 





Open... Ctri*O | 
Dpen as Text,,. arisbie Editor 
Open "function" crD | 癌 马 量 | | 区 司 -| 四 路 
En 唱 喝 量 唱 塌 | - llo i+il+ll li x | ?> 
Close… | : function y = ruku(fx, xmair Re 
Glose ruku.m Cul*W | 2 司 % 采用 四 阶 龙 格 库 撕 法 雪 值 积分 
， 3 % fx 为 辑 名 
0 为 自 变量 的 初始 什 
| 项 * 巡 于 相 且 
| ”SepAx ea 
0 15 % 70 为 因 遍 重 的 初始 值 
Save 16- |h=001 % 步 长 
Save Backup… | 了 7- X = xmain:h:xmax : 半 自 朗 重 
Pubish ruku.m 8 =- nmn= lenethfxzl- 和 计 牙 点数 
Pubjish Configuration for ruku.m Y ruku | 向 鲁 
Source Control 中 E 蜡 publsh Configurationsforrukum，[、 
]jmr-rt Data... 朵 - for 1=1:mn 


图 1.4.1 选择 发 布 菜单 项 


(1) 打开 M 天数 文件 ruku. m。 

(2) 选择 按钮 人 右 侧 的 下 拉 箭 头 #-~=> Edit Publish Configuration for ruku. m. . . 。 

(3) 在 MATLAB expression 文本 框 中 输入 函数 调用 代码 ,并 按 需 要 修改 发 布 文档 的 格式 
以 及 所 包含 的 内 容 , 如 图 1. 4. 2 所 示 。 


ruiu_m 关 ，pPubiish configurstion nerme，ruku 

re eevror 

| [1 园 
ice ， 


|fz = @lx,y) x73-y 
rukutfx, -3 2) 


RN User Defau 必 下 | SaveAs | 
WEtYinge eee< 
Dutpwut file formmeot htrnl 
Dutpwus folder CNMATLAB\boecimprogramhtml 
区 上 旬 e 


Figwre settinqs 
Figure capture method ”entireGUPWindow 
jmage Format defauk tpng) 
Use new figure true 
Max mage width (pueisj jnf 
Max mmege heighe (Pirek) Inf 


Create thurmbnail true 
-=《eode vcttqy 

Jmciude code true 

Evaluate code true 

Catch error true 


Nar 关 cf output ines jnf 





[co ] [pb | Hap -| 


图 1.4.2 发 布 配 置 选项 
(4) 生成 报告 文档 ,如 图 1.4. 3 所 示 。 
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Contents 
。 四 防 龙 格 座 塔 法 
sl1 
e 2 
se 上 3 
es Kd4 
sYCn+1l 
大 


四 阶 龙 格 库 塔 法 
for i=l3:n 
Kl = feval (fx, xfi),y(i)); 


| 
end 
本 
| 
| 


y = y(li:n); 

plot (xy) ; 

titlef 1 crGer Ronge-Xutta ) 
xlabelfC z ); 划 X 抽 标 答 
ylabelf(y ); % 了 拍 标 等 
grid on; 


4 order Runge-Kutta 





图 1.4.3 生成 报告 


醒 : 基于 模型 的 设计 一 一 MCU 篇 


1.5 上 Embedded MATLAB 


Embedded MATLAB 是 MATLAB 的 一 个 子 集 , 它 支持 从 概念 到 实现 的 编程 理念 。 其 优 
势 在 于 :可 用 易于 编程 的 MATLAB 语言 替代 C 语言 ;用 MATLAB 语言 编写 的 M 代码 可 直 
接生 成 高 效 的 对 和信 式 C 代码 或 HDL 代码 ;特别 是 R2010b 支持 可 变 大 小 数据 的 动态 内 存 分 
配 , 大 大 提高 编程 效率 ,降低 编程 难度 。 读 者 在 后 续 章 节 将 看 到 Embedded MATLAB 非凡 的 
表现 力 。 

作者 在 人 《基于 模型 的 设计 及 其 散人 式 实现 ?一 书 中 详细 介绍 了 Embedded MATLAB 的 编 
程 规范 以 及 注意 事项 ,读者 可 以 阅读 相关 部 分 , 而 更 全 面 \ 更 权威 的 Embedded MATLAB 信 
息 请 参考 MathWorks 公司 的 技术 手册 。 本 节 以 一 个 实例 简要 介绍 Embedded MATLAB 的 
应 用 。 


1.$.1 Embedded MATLAB 的 主要 功能 特点 


1，Embedded MATLAB 支持 的 功能 (R2010b 版 ) 


(1) 支持 400 多 个 MATLAB 运算 符 . 浮 点 函数 ,超过 120 个 定点 工具 箱 函 数 , 以 及 超过 
70 个 信号 处 理 晒 数 。 

(2) 支持 多 维 阵列 .实数 和 复数 .结构 .流程 控制 和 下 标 运算 等 高 级 MATLAB 语言 功能 。 

(3) 支持 直接 在 M-code 文件 中 调用 Real-Time Workshop 工具 箱 。 

(4) 支持 在 Simulink 中 做 人 Embedded MATLAB 用 户 自 定义 模块 。 

(5) 支持 在 Stateflow 中 岩 入 Embedded MATLAB 琐 数 模块 。 

(6) 支持 加 快 M-code 文件 定点 算法 的 仿真 速度 。 

(7) 支持 直接 从 Mr-code 文件 生产 HDL 代码 。 

(8) 支持 集成 已 存在 的 用 户 C 语言 算法 到 Embedded MATLAB 模块 中 。 

(9) 支持 可 变 大 小 数据 (R2009b 新 增 ) 。 

(10) 支持 全 局 变量 (R2010a 新 增 ) 。 

(11) 支持 结构 体 数 据 类 型 (R2010a 新 增 ) 。 

(12) 支持 可 变 大 小 数据 的 动态 内 存 分 配 (R2010b 新 增 ) 。 

(13) 支持 增强 编辑 报告 (R2010b 新 增 ) 。 

(14) 支持 用 更 少 的 静态 内 存 来 生成 MEX 数 (R2010b 新 增 ) 。 

2。Embedded MATLAB 所 受到 的 限制 

(1) 不 支持 元 胞 数组 。 

(2) 不 支持 MATLAB 对 象 。 

(3) 不 支持 内 岩 函 数 。 

(4) 不 支持 稀 玻 矩阵 。 

(5) 不 支持 可 视 化 。 


-生生 于 
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(6) 不 支持 Java。 

(7) 不 支持 try/catch 语句 。 

(8) 不 支持 Matrix deletion 。 

(9) 不 支持 枚 举 数据 的 冒号 操作 (R2010b 新 增 ) 。 

Embedded MATLAB 子 集 如 图 1. 5. 1 所 示 ,具体 Embedded MATLAB 本 数 列表 见 附 录 。 


java objects 


sparse “Vizulization 


MALT 


cellarrays _ analysis 


Nested functions 





图 1.5.1 Embedded MATLAB 子 集 


1.S$.2 Embedded MATLAB 的 编程 规范 


1、Embedded MATLAB 遵守 的 规范 


(1) 首先 必须 满足 MATLAB 程序 的 语法 规范 。 
(2) 其 次 还 得 满足 Embedded MATLAB 语法 规范 。 


2，Embedded MATLAB 规范 检查 的 步骤 
(1) 首先 用 cell 将 程序 分 段 ,然后 用 M-Lint 对 代码 进行 MATLAB 程序 语法 检查 ,并 根 


据 提 示 修 改 错误 ,缩小 错误 范围 。 


(2) 在 M 文件 开头 或 第 二 行 未 尾 加 上 Embedded MATLAB 编辑 指令 外 井 _eml, 继 续 用 


M-Lint 对 M-code 进行 设计 时 的 Embedded MATLAB 语法 检查 ,并 根据 M-Lint 的 建议 修改 
错误 已 


(3) 用 emlmex 指令 对 M 代码 进行 C 代码 生成 时 的 Embedded MATLAB 兼容 性 检查 ， 


并 根据 错误 报告 修改 错误 。 


1.5.3 “C 编译 器 的 设置 


在 实现 MATLAB 编译 器 的 各 种 功能 之 前 (如 mex) ,需要 指定 MATLAB 编译 器 。 
C 编译 器 的 设置 过 程 如 下 : 


可: 基于 模型 的 设计 一 一 MCU 篇 


>> mex - Setup 


Please choose Your compiler for building external interface (MEX) files; 


Would you like mex to locate installed compilers [Y]/n? 


(1) 选择 y, 按 Enter 键 ,代码 如 下 : 


Would you like mex to locate installed compilers [Y]/mn? Y 


Select a Compiler; 
[1] bce - win32 C 2.4.1 in C:\PROGRR 一 1NMRATLRBN\R2010bNsysN\1lcc 
[2] Microsoft Visual C+ + 2008 SP1 in C:\Program FilesNVMicrosoft Visual Studio 9.0 


[0] None 


Compliler: 


(2) 选择 1, 则 使 用 MATLAB 自 带 的 LCC 编译 器 , 它 只 能 编译 C 代码 ,不 能 编译 C 十 十 
代码 。 代 码 如 下 : 


Compiler: 工 
Please Verity Your choices; 


Compiler: Lcc 一 Win32 C 2.4.1 
Location: C:\PROGRR 一 1\MRTLRABN\R2010bN\sys\V1lcc 


《3) 选择 2, 则 使 用 作者 机 器 上 安装 的 Microsoft Visual C 十 十 2008 作为 C 编译 器 。 代 码 
如 下 : 


Compiler:， 2 
Please verify Your cholices: 


Compiler: Microsoft Visual C+ + 2008 SP1 
Location: C:\Program FilesN\Microsoft Visual Studio 9.0 


Rre these correct [Y]/n? 


(4) 选择 y, 按 Enter 键 完 成 C 编译 器 的 设置 ,代码 如 下 : 


RMre these correct [Y]/n? Y 


闪闪 闪闪 闪闪 关 凑 六 拓 其 其 其 关 并 美 其 浴 其 其 其 其 凑 闫 关 关 关 其 其 关 凑 其 其 关 关 闪闪 关 关 并 闪闪 关 并 关 关 次 关 关 关 其 关 并 关 凑 其 闫 关 其 其 其 美 凑 凑 美 
Warning:MEX - files generated using Microsoft Visual C+ + 2008 require 
that Microsoft Visual Studio 2008 run 一 time 1ibraries be 


“26。 - 荆 
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avalilable on the computer theVy are run on. 
If you plan to redistribute Your MEX ~- files to other MATLRAB 
UserSs，be Sure that theVy have the run ~ time libraries， 


其 六 闪闪 其 其 其 诈 凑 其 凑 其 关 济 新 其 六 闫 六 话 六 其 其 拓 六 闪闪 其 基 其 关 六 诉 凑 商 其 关 尖 并 其 其 其 基 尖 六 其 闫 关 并 关 尖 关 六 突 关 其 关 关 凑 美 闫 其 天 旗 话 


Trying to update options file: C:\Documents and Settings\ NO.1N Application DataN MathWorks\ MRAT- 
LARBN R2010b\ mexopts. bat 
From template: C:NPROGRR 一 1 \MRTLRBN R2010b\ binN win32\ mexopts\ msSVc90opts. bat 


Done . . . 


关 疾 其 关 其 放 汪 其 其 关 共 关 关 其 其 其 尖 六 话 凑 凑 其 其 并 并 其 其 关 兴 共 其 浙 话 捧 泊 兴 诉 其 凑 基 尖 并 并 详 关 匠 六 状 诉状 括 拓 关 并 其 次 其 其 基 闪 关 六 其 关 新 
farning:The MATLAB C and Fortran API has changed to support MARTLAB 
variables with more than 2"32 - 1 elements，In the near future 
You will be required to update Your code to utilize the new 
RARPI，You can find more information about this at; 
http:/ /www. mathworks. com/ support/solutions/en/data/l - 5C27B9/ ? solution = 1 - 5C27B9 
Building with the ~- largeRrrayDims option enables the new API. 


凑 拓 其 并 闪闪 其 其 关 话 六 疾 产 白 关 并 关 其 凑 其 其 关 放 其 凑 凑 关 六 庭 其 其 天 扰 关 关 基 其 白 关 关 六 其 其 关 关头 头 证 闫 基 闪闪 六 其 其 闫 其 并 关 省 其 闫 闪闪 关 


1.5.4 Embedded MATLAB 编程 实例 


沿用 例 1. 2. 4 来 说 明 Embedded MATLAB 程序 的 编程 规范 .调试 过 程 以 及 嵌入 式 C 代 
码 生 成 过 程 。 


1 MATLAB 语法 检查 
为 了 说 明 MATLAB 语法 检查 的 过 程 ,以 下 代码 引入 了 若干 错误 ， 


function str = leapyear(YyY) 
$% 5$% 判断 一 个 年 份 是 否 为 半年 


if rem(y,4) = 0 $% 年 份 能 被 4 整除 
庄 rem(yY,100)== $ 是 否 是 整 100 年 
if rem(Y,400)==0 多 整 100 年 能 否 被 400 整除 
leap = 1; #% 整 400 年 ,是 半年 
elSe 
leap = 0; $ 整 100 年 但 非 整 400 年 , 非 闽 年 
end 
elSse 
leap = 1; % 被 4 整除 但 非 整 100 年 ,是 半年 
end 
elSse 


s 
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leap = 0; $ 不 能 被 4 整除 , 非 关 年 
end 


% $ 输出 结果 
if leap == 
str = strcat([num2str(y) ,IS a leap year. ]); 
% 若 leap 为 真 , 输 出 肯定 字符 串 
else leap ==0 
str = strcat([num2str(Y) ,is NOT a leap Year. ) ; 
$% 若 leap 为 真 , 输 出 否定 字符 串 


end 


编辑 器 窗口 右 侧 M-Lint 消息 区 出 现 多 个 带 有 颜色 的 横 条 ,上 方 的 小 方块 显示 当前 M 文 
件 的 语法 检测 状态 ,如 图 1.5.2 所 示 。 


Fle Edt 了 Jet Go cell Tooks Debug Desktop Window Help 守 
站 这 加 | 关 寺 只 机 和 省 刀 | 的 和 路 及 | 虽 - 有 将 雹 区 由 汗 本 
唱 唱 温 唱 旦 ;| -1 +ij:>l ix]| 淆 吃 | 和 
1 turnction str = 上 eapyecartf 了 ) | 
2 %% 天 上 断 一 个 年 份 是 否 为 亲 年 
3 -- 示 reaity, 3)=0 5% 年 答 琵 被 4 整 阴 3 
一 if renty, 100)==f % 是 赤 是 丈 100 年 
| 5 一 if ranhty, 400==0 % 昔 100 年 能 吾 被 400 芍 际 
6 一 1eap=1l; 5 著 400 年 ， 是 亲征 
一 已 SS 己 
8 一 1eap=0 Y% 昔 100 年 但 非 艺 300 年 ， 非 头等 : 
9 一 and 
10 一 esSe 
Li 一 Leap=l 3 昔 除 但 非 蔚 年 ， 是 闭 年 
12 一 end 
13 一 e 1 Se 
14 一 Jeap=0 不 能 被 4 整除 ， 扯 
入 一 end 攻 s、 
16 %5% 东 出 结果 
17 一 if leap==l 
| 18 一 stzr = strcat i [nun2str(y),” II5 sa leap year ]) :; 
Le k 车 leap 为 真 ， 输 出 次 定 字符 串 | 
leapyear tn 19 Col 37 1 


1.5.2 MATLAB 语法 检查 结果 


(1) 红色 : M 文件 至 少 有 一 个 语法 错误 。 对 于 某 些 错误 , M-Lint 会 高 亮 显示 ,如 未 结束 
的 字符 串 、 不 匹配 的 关键 词 、 圆 括 弧 、 花 括 弧 、 方 括 弧 等 。 

(2) 橘 黄色 :M 文件 有 警告 或 者 值得 改进 的 代码 ,但 没有 语法 错误 。 

(3) 绿色 : M 文件 没有 任何 语法 错误 、 警 告 以 及 可 改进 的 代码 。 

同样 地 ,代码 下 方 带 有 红色 波浪 线 的 表示 有 语法 错误 ,代码 下 方 带 有 橘 黄色 波浪 线 的 表示 
有 警告 或 待 改 进 。 首 次 单 击 小 方块 ,光标 将 定位 理 筹 一 个 包含 M-Lint 消息 的 代码 段 , 再 次 单 


:人 和 
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击 则 和 定位 至 下 一 个 代码 段 :当然 用 户 也 可 以 直接 将 鼠标 指针 停留 在 M-Lint 消息 区 的 颜色 横 
条 或 带 有 波浪 线 的 代码 段 ,M-Lint 即 给 出 提示 或 修改 意见 。 

如 图 1. 5. 3 所 示 ,M-Lint 提示 第 3 行 存在 语法 错误 。 

检查 第 3 行 代码 可 以 发 现 ,if 的 判断 条 件 应 使 用 “==”, 而 不 是 “三 ”, 按 此 修改 后 ,代码 下 方 
的 波浪 线 与 消息 区 的 颜色 横 条 即 消 失 了 。 





| 荆 furnction str = 1eapyear( y ) 9] 国 

| 2 % 尖 判 盯 一 个 年 份 是 否 为 国 年 

晤 下 if remty, 100)==0 丰 是 知 是 查 100 年 [ 双 

| 丰 一 if remty, 400)==0 4% 莫 100 年 月 天 被 400 垄 除 | 
从 Lesap=1l; 4 获 300 年 ， 旺 半年 | | 


图 1.5.3 第 3 人行 错误 提示 

针对 第 20 行 ,M-Lint 给 出 了 提示 1:Line 20: Possible inappropriate use of == operator. 
Use 一 if assignment is intended 与 提示 2:Line 20: Terminate statement with semicolon to 
suppess output (in functions). ,并 各 提供 了 一 个 Fix 按钮 。 如 果 按 下 第 1 个 按钮 ,系统 自动 
用 一 替换 ==, 按 下 第 2 个 按钮 ,系统 自动 在 行 末 加 入 一 个 分 号 ,如 图 1. 5.4 所 示 。 另 外 单 击 提 
示 2 的 蓝 色 链 接 , 还 可 以 查看 详细 的 修改 意见 ,如 图 1. 5. 5 所 示 。 

但 详细 分 析 代 码 , 计 条 件 语 句 的 else 分 支 无 须 再 作 判 断 , 而 M-Lint 将 leap == 0 当做 普通 
的 赋值 语句 ,因此 显然 应 直接 删除 该 代码 。 





和 一 zt leap==1 

| 18 一 

| 19 

| 20 一 else 1eap==0 
2 | st = Strcat([nun2str(y),，， is NOI a leap year. 
22 % 知 1eap 为 真 ， 输 出 否定 字符 时 | 下 


图 1.5.4 第 20 行 错误 提示 


工 Line 20; Possible inappropriate Use of == Operator, Use = 入 assignment is intendeg， F， 
Fk 


Explanation 


kt appearsthis staterment producesavaluethat displays atthe comrmmand hne when the 
5taterment executes. Thisis usually undesirable in functions because someone else calling 
thefunction might not expect or need the output. Sometimes (usually dueto overloadingh 
M-Lint E Incorrect and the expression produces no output， 


Suggested Action 


Becausethereis lfttle harm in putting a semicolon afterthe statement even 半 the statement | 
does not resu 比 in displaying output use the context rmenuto add a sermicolon. 和 You want | 
the output to display, then usethe context rmenu to 5uppPres5s the rmes589e， 








图 1.5.5 修改 意见 


第 20 行 的 修改 方式 说 明 ,M-Lint 并 不 能 针对 各 种 情况 给 出 完全 正确 的 判断 ,有 些 时 候 用 
户 不 需要 修改 代码 ,也 不 需要 M-Lint 给 出 提示 信息 ,因而 要 屏蔽 M-Lint 消息 ,当然 ,用 户 不 


莹 29 。 ; 


要 : 基于 模型 的 设计 一 一 MCU 篇 


能 屏蔽 M-Lint 的 语法 错误 提示 。 

屏蔽 消息 有 多 种 实现 方法 : 

(1) 针对 当前 文件 的 某 种 情况 ,屏蔽 一 次 M-Lint 消息 。 

(2) 针对 当前 文件 的 某 种 情况 , 均 屏蔽 M-Lint 消息 。 

(3) 针对 所 有 文件 的 各 种 情况 , 均 屏 蔽 M-Lint 消息 。 

(4) 设置 默认 的 M-Lint 消息 规则 。 

(5) 设置 用 户 自 定义 的 M-Lint 消息 规则 。 

右 击 带 有 波浪 线 的 代码 段 ,查看 菜单 项 Suppress“Possible inappropriate use of ==. .. ”下 
的 选项 ,如 图 1. 5.6 所 示 。 


1 一 str = Strcat ( [num2str(y),”1JI5 3a leap ye3ar。。]) : 
19 5 车 1eap 为 真 ， 笨 出 背 定 字符 出 
[名 -- elSse 1eap==0 
| 21 str = 5 Replace == by =. Alt+Enter 
22 Suppress "Possible inapPropriate use of == | On This Line 
|23 一 end Open Message Ctrl+ M jn This File 
| 24 一 end 风 In All Files RN 
| 25 
| 25 Open Selection Ctrl+D 


图 1.5$.6 屏蔽 M-Lint 消息 菜单 
(1) On This Line 表示 针对 当前 行 , 屏 蔽 一 次 M-Lint 消息 。 
(2) In This File 表示 针对 当前 文件 , 均 屏 藤 M-Lint 消息 。 
(3) In All Files 表示 所 有 文件 , 均 屏 蔽 M-Lint 消息 。 
由 于 该 行 存在 两 个 M-Lint 提示 ,用 户 需 要 进行 两 次 屏蔽 消息 的 操作 ,最 后 M-Lint 将 在 
代码 末尾 加 入 外 #ok<* NOPRT, * EQEFF> ,表示 在 当前 文件 不 再 对 该 类 代码 提出 警告 ， 
如 图 1. 5.7 所 示 。 


| 16 %% 力 出 结果 

| 17 一 lf Teap==1 

|18 -- str = Strcat([mum2str(ty)j,， IS a leap year，]) : 

19 % 若 1eap 为 真 ， 输 出 肯定 字符 串 
|20 一 else leap==0  %#OoKE<7YNOPRI，x*EQEFF 

| 21 str = Strcat([num2str(y),” is NOT a leap year。 】: 

| 22 % 若 1sap 为 真 ， 和 匡 出 否定 字符 串 
| 23 一 end 


图 1.5.7 屏蔽 消息 的 效果 
最 后 一 个 M-Lint 消息 提示 第 21 行 存 在 语法 错误 ,可 能 是 缺少 某 一 类 的 括 弧 , 如 图 1.5.8 
所 示 。 对 照 检查 第 19 行 代码 可 以 发 现 , 代 码 中 缺少 一 个 “]”。 
根据 提示 ,完成 了 所 有 代码 修改 ,M-Lint 消息 区 的 小 方块 显示 绿色 ,表示 代码 通过 了 
MATLAB 的 代码 规范 检查 ,如 图 1. 5.9 所 示 。 


:人 30 到 
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17 一 证 Jeap==1 
18 -~- str = Strcati[nuns2strityi,”I5 a 1Lesp Year ]) 1: 
20 - el1Se 
| 21 str = Strcat([frmun2strty)” is5 IOT sa Iceap 7esr。】 
| 22 外 若 ijeap 为 真 ， 稍 出 天 定 闻 符 囊 
23 -一 end 
图 1.5.8 第 21 行 错误 提示 
Ps Edt Iedt Go Gel Teos Debug Desktop 是 ndow Help 时 
1 过 而 上 吉大 本 二 悦 的 和 四 有 | 区. 目 站 境 人 由 进 共 
加 增 人 冀 缚 塌 | 上 -0 ty。 1 二 六 和 
functxon Str = Jeapyear yy 】 0 
2 SS 到 有 昧 一 个 年 份 是 吉 为 鹿 年 
3 -- 这 Temiy, 3)== 5 平反 成 镇 5 攻 | 
才 一 27 rem 17, 100i== 昌 $ 生 世 多 大 109 诲 
S - 计 reaily, 300)==0 浆 155 年 乓 否 补 420 莫 ? 人 
站 - leap=1 加 41 年， 
7T 一 二 15< 
8 ~ leap=0 5 于 年 也 入 票 4080 冬 
和 一 end 
妇 - 二 3 
叶 - le3sp=1 S 入 4 加 基于 106 年 ， 基 国 笃 
啼 = fnd 
13 -~ 必 各 人 
让 一 leap=0 忧 油 :3 昔 娠 ， 非 舍 秆 
后 一 end 
16 %% 区 出 处 宁 
二 一 if lesp==1 
娩 ~ sr 三 Strcat1 [ra2striy)， = ]) ; 
1 5 基 1ssy 为 总， 编 出 靖宇 字 他 旦 。 


leapyear 


Ln 基 Col 于 


图 1.5.9 通过 了 代码 规范 检查 


2. 设计 时 Embedded MATLAB 语法 检查 
在 程序 的 第 一 行 末 尾 或 下 一 行 加 上 指令 中 # eml, Mrlint 消息 区 的 小 方块 颜色 没 发 生变 
化 ,表示 通过 设计 时 规范 语法 检查 ,如 图 1. 5. 10 所 示 。 


Taoks Debug Desktop Window Hetp 
-的 和 加 丰 | 下 站 者 二 出 圾 


Pie Edt JIet So Sell 
可 是 xx 均 耻 让 | 印 





唱 怒 党 副 遇 -0 +i+l xi1 滞 :| 和 有 

1 funection str = Leapyearlt y ) 

: 

3 5%% 判 曰 一 个 年 份 是 去 为 记 年 

5 一 if reaiy, 4)==0 % 年 扩 尿 这 3 区 至 

和 ~ 证 zeaty, 100)==0 % 星 妨 是 贡 100 年 | 
下 ~ if rea(y,400)==0 % 莫 100 年 表 否 被 5300 怪 妹 
T ~ leap=1! % 树 205 和 证， 是 翌年 | 
S 一 二 二 到 
9 ~ leap=0 % 加 100 和 十 但 李 畦 400 年 ， 非 国 年 
i 一 end 
计 ~ 者 工 5 f 届 
12 ~ leap=1 % 证 4 军 生 位 革 硅 100 年 ， 是 国 评 
13 ~ end 

1 一 会】 号 作 | 
15 ~ leap=0: % 于 能 被 3 芍 际 ， 丰 计生 | 
1 一 end 
| 好 %% 轮 册 结果 
138 ~ 这 leasp==| 

的 - st = Strcatt [rm2strfy)， 二 eam ye3r ]) id 


leapvesr 


col 了 


图 1.5.10 通过 设计 时 规范 检查 


in ] 寺 VR 


苇 习 基于 模型 的 设计 一 -MCU 篇 


3. 代码 生成 时 Embedded MATLAB 兼容 性 检查 
在 命令 行 输入 命令 : 


>> emlmex ]eapVYyear - Teport 


命令 行 继而 显示 以 下 错误 信息 ,说 明 检 查 失败 : 


?373 The function 'num2str "is not supported by Embedded MATLRB for code generation. See the docunmen- 
tation for eml. extrinsic to learn how You can Use this function in Sirmulation， 

Error in ==> leapyear Line: 19 Column: 20 

C -~ MEX generation failed:; Open error report. 


?2?? Error using ==> em]nmex 


单 击 Open error report 按钮 打开 错误 报告 ,如 图 1. 5. 11 所 示 ,提示 信息 指出 Embedded 
matlab 无 法 生成 num2str 等 郴 数 的 代码 ,为 此 需要 对 代码 进行 改造 。 


MATLAEB Eode Call siaxk Funcbon jeapyear 5e 红 3 志 PCUOP CSCe 
5 


Sunsmeary “AMessa0es(i] Varocbes 


twdew FYPA EM TYA jesitotOn 


名 


21203222 二 TY 


图 1.5.11 错误 报告 


将 代码 的 输出 部 分 修改 如 下 : 
了 leap == 1 
Str = 1; 
else 
Str = 0; 
end 
在 命令 行 继续 输入 命令 : 


>> emlmex Jeapyear - report 


命令 行 显示 以 下 错误 信息 ,说 明 检 查 仍 旧 失 败 
?33? Build error : Compilation returned error status code 2. See the target build 1og for further de- 


talls. 


Error in ==> leapyear Line: 1 Column:， 1 


国 32 党 
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C -~ MEX generation failed:， Open error report. 
?2?7 Error using ==> emtheoai 





这 是 由 于 代码 注释 中 包含 了 中 文字 符 , 将 所 有 注释 删除 或 用 英文 代替 ,再 次 创建 C - 
MEX 荔 数 即 可 成 功 , 如 图 1.5. 12 所 示 , 生 成 报告 如 图 1. 5. 13 所 示 。 


Ele Edt Debug Desktop Window Help 


习 
>>》 二 机 ] EX ] 二 3SDYESIE ~ 上 EDPQLt 
C-)EX generat1lon Successful: Open coder report. 
度 >| 
本 
1.5.12 创建 C-MEX 函数 成 功 
“MANFLAB code 。 21 stock Funcbon: jeapYesr Ac 1 Caf- 汇 
3 可 - me -二 二 
Segae 
】 关 攻 
6 
这 ear 及 
诲 ai 
SmenaarY AI Mewsse0en (0) Varalimw 
Provade Feeclbk 
Ereddsy NATLAB.C 
TREEEEECEEETR IEHEEER ITITIOERREEESCECESEOSSE 


图 1.5.13 成 功 报告 
4. 生成 藤 入 式 C 代码 


在 命令 行 中 输入 命令 ,提示 代码 生成 成 功 , 如 图 1.5. 14 所 示 。 


>> emlc leapVear -cC -report -了 T rtw:1ib 


Ble Edt Debug Desktop Window Help 习 


>》 Be 及 LC 1eapyear -5 -Leport 一 fwWI1Ib 


Comp1llatlon successful: Open conp1llat1orn Feport。 


产 | 


图 1.S$.14 生成 几 入 式 C 代码 成 功 


单 击 链接 ,查看 生成 报告 ,如 图 1. 5. 15 所 示 。 继 续 单 击 报告 左 侧 导 航 窗口 的 C code 页 ， 
查看 生成 的 C 代码 ,如 图 1. 5. 16 所 示 。 


本 
二 


可: 基于 模型 的 设计 一 一 MCU 篇 


ERRaode ca “coode fondiiniiapa 辣 5 soec hncon orste 下 


goumcczcon SEE ”Leapyearft y ) 


园 Fer 和 ncton 罗 by 5 Ze | 
Fe See | 3 54 草 品 一 个 年 份 显示 为 同年 | 
1xi 了 4 zemiy, 4)ma0 旺 
We ny 玉 zz >esityY, 1I00) me0 | 
ES 三 zz zxegii7， 400)==0 mt 
3 e13e 
瑟 espP=O: 
29 en 
1 E3e 
3 manryzsT， 症 


SS Al Messages (0) Variables Target Buad Log 
Csource code generated on 15-Oct-2010 16;23;22 


Codng target: RTW Lbrary 
Nurmber 0f errors: 上 

Nurmber of warnin05s: 2 

Provide Feedback 


We Value Your feedback. Piease take a few minutes to 30SWer 引 上 5 short SUrvey regardng 
the Embadoced MATLAB Compilation Report. 


> 二 有 ke SurvRY 





图 1.5.15 和 嵌入 式 C 代码 生成 报告 


再 Souwrce Files ea e 让 
4 Stattie Te T xzE_ ZERd_ Sn (real RDD，Feal TI em1 1 
| 

Zea 了 ER 了 7 
bcaleaD IT ez 上 昂 
bcoSLiean_ T em 二 了 
XeS3L 了 EL 7 
SF 本 了 = fix5I3IaNIemI 20)) 5 (5IT2InEIeFL_ SG) 11 
er 和 了 了 一 【1 ZES3J8N TeTI TI) 二 全 人 zcTsERnTE em 人 妈 ) )) 坟 过 


于 - Si 本 全 
条 II 全 





《Souice code generated on 15-OCG-2010 16:23:22 
汪 广 confinkeh Codnmg target: RTVW Uprary 
二 qdtypash Number of errors: 0 

Number of Warnmg05: 妈 

provde Feedback 


We vakse YOUT 二 ce0bacx. please ake 3 few menutesto ansSWer ths 外 SUrvey 1egardng 
由 se Emoegded MATLAB Comp 直 on Repoc 比 


图 1.5.16 生成 的 C 代码 
s. 加 入 Embedded MATLAB 模块 


在 Simulink 模块 库 找到 Embedded MATLAB 模块 ,如 图 1. 5. 17 所 示 ,添加 到 一 个 空白 
的 模型 , 按 图 1.5. 18 连接 ,并 将 模型 与 M 函数 leapyear. m 保存 在 同一 个 县 录 。 


上- Signal Routing 2 
-Sinks 
Sources 
User-Defined Functions 

由 -Additional Math & Discrete 
由 - 轴 communications Blockset 
- 骂 control system Toobox 





3 
| sb 和 To 一 二 下 


图 1.5.17 Embedded MATLAB 模块 
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Constant 


Embedded 
MATLAB Function 


图 1.5.18 连接 模型 
双击 打开 Embedded MATLAB 模块 ,在 编辑 窗口 加 入 以 下 代码 , 即 可 调用 该 了 郴 数 。 


function Y = fcn(uDy) 
第 井 em] 
Y = leapyear(u) ; 


仿真 结果 如 图 1. 5. 19 所 示 ,显示 模块 第 二 行 的 “1? 说 明 2912 年 是 冰 年 。 


randif(3000} 


Constant 





Embedded 
MATLAB Function 


图 1.5.19 "仿真 结果 
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第 2 章 
Simulink 建 模 与 调试 


Simulink 是 动态 和 骨 人 式 等 系统 的 建 模 与 仿真 工具 ,也 是 基于 模型 设计 的 基础 。 对 于 机 
电 、 航 空 航天 、 信 和 号 处 理 、 自 动 控 制 . 通 信 、 音 视频 处 理 等 众多 领域 ,Simulink 提供 了 交互 式 的 
可 视 化 开发 环境 和 可 定制 的 模块 库 , 对 系统 进行 建 模 、 仿 真 与 调试 等 。 并 可 实现 与 Stateflow 
有 限 状 态 机 的 无 缝 连接 ,扩展 对 复杂 系统 的 建 模 能 力 。 

通过 Simulink 模块 库 自 带 的 1000 多 个 预定 义 模块 ,基本 上 可 快速 地 创建 基于 MCU 器 
件 应 用 的 系统 模型 。 运 用 层次 化 建 模 .数据 管理 , 子 系 统 定 制 等 手段 ,即使 是 复杂 的 嵌 人 式 
MCU 应 用 系统 ,也 能 轻松 完成 简明 精确 的 模型 描述 。 

大 量 使 用 Embedded MATLAB 来 创建 用 户 自 己 的 算法 模块 ,可 大 大 加 快 建 模 速度 。 读 
者 在 后 面 的 内 容 中 ,会 经 常 看 到 用 Embedded MATILAB 创建 的 算法 模块 ,加 快 MCU 器 件 开 
发 的 实例 。 模 型 是 基于 模型 设计 的 起 点 ,同时 也 是 最 核心 的 东西 。 本 章 将 以 基于 PID 控制 的 
直流 电动 机 的 物理 建 模 与 调试 为 例 来 介绍 Smulink, 更 详细 的 内 容 请 读者 参考 MathWorks 
公司 相关 内 容 的 用 户 手册 。 

Simulink 的 主要 特点 如 下 : 

(1) 众多 可 扩展 的 模块 库 。 

(2) 利用 图 形 编辑 器 来 组 合 和 管理 模块 图 。 

(3) 以 系统 功能 来 划分 模型 ,实现 对 复杂 系统 的 管理 。 

(4) 利用 模型 浏览 器 (Model Explorer) 寻 找 、 创 建 . 配 置 模型 组 件 的 参数 与 属性 。 

(5) 利用 API 实现 与 其 他 仿真 程序 的 连接 或 集成 用 户 代 码 。 

(6) 用 图 形 化 的 调试 器 和 前 析 器 来 检查 仿真 结果 ,评估 模型 的 性 能 指标 。 

(7) 在 MATLAB 命令 窗口 中 ,可 对 仿真 结果 进行 分 析 与 可 视 化 , 自 定义 模型 环境 、 信 和 号 
参数 和 测试 数据 。 

(8) 利用 模型 分 析 和 诊断 工具 来 确保 模型 的 一 致 性 ,定位 模型 中 的 错误 。 

(1) Simulink 基本 操作 。 

(2) 搭建 直流 电动 机 模型 。 

(3) Simulink 模型 调试 。 


1 36 
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2.1 Simulink 基本 操作 


2.1.1 模块 库 和 编辑 窗口 


1. 打开 模型 库 浏 览 器 


在 matlab 的 命令 窗口 中 输入 simulink 指令 或 单 击 matlab 工具 栏 上 的 simulink 图 标 轨 
就 可 以 打开 模型 库 浏 览 器 ,如 图 2. 1. 1 所 示 。 


四 9 一 Te 
| 最 Smoknk Library Browser 多 
[Si Ed Yew Help 
se 上 人 六 站 
口 芒 | Eniersearchierm | 痢 
| | Libranes Library Smusnk Sesrcb ae 了 
st vv Eee 
| Commoniy USed BlociS aa 
| Conbnw0yS 
-Dacernutes 0 
DScrete 
LoOC and Bt Operalcps 
LookuP Tables SN 
air Dperatons 
| Wedel Verrcasson Cramere 


| 
NodeHWIGe U1 沿 村 5 二 
Po 8 SubSys3ems Log'c sndg Bwt 
台 Smai Tutes 
Snre' RNovtn3 
SAs ] 
Scurces 
UsSer-Defned Funcions 军 

+ Addipnsl Mah 5 Decrete 
+ 了 总 er0SPSCce 于 CUSE 油 
+ 了 commuoeatens 5pctsei 
莱 Conrol System Too5cx 
-最 Dasacauaten Topesox 了 | 


Showing Senusn 





图 2.1.1 模型 库 浏 览 器 
2. 打开 模型 编辑 窗口 


要 建立 一 个 新 的 模型 ,首先 要 打开 一 个 模型 编辑 窗口 。 可 以 通过 单 击 模块 库 浏 览 器 上 的 
NEW Model 按钮 ,或 File 一 NEW->Model 来 打开 窗口 ,如 图 2.1. 2 所 示 。 


| 哆 Smulinok LUibrary Browser 
Bile Edikt View Help 
1 回 B 。FEeeswaem 司 鸭 看 


| 人 Li 和 rary Sazmulnk Search Resu 


5 Comrmonly Used 
| 3 Bloos 


Be Edr Wew Heip 


[av ModN co 














也 Qpen Ctrl*O LUibrary | 
Pors 8 记 Looiz and BR Silose ]】 
| mm ea 目 臣 ESD | 
| Showing: Simulnk 四 | Preferences,.， | 


图 2.1.2 打开 模型 编辑 窗口 


瑟 : 基于 模型 的 设计 一 一 MCU 篇 


2.1.2 Simulink 模块 库 


Simulink 模块 库 是 建立 模型 的 基础 ,其 中 赛 括 了 大 量 的 基本 功能 模块 ,只 有 当 用 户 熟 练 
地 掌握 了 模块 库 ,才能 快速 .高效 地 建立 模型 。 从 图 2. 1. 1 所 示 的 模型 库 浏 览 器 可 知 , 在 Sim- 
ulink 模块 库 中 包含 以 下 子 模块 库 , 如 表 2. 1. 1 所 列 。 
表 2.1.1 模块 库 列 表 


常用 模块 (commonly used block) 连续 模块 (continuous) 
非 连 续 模 块 (discontinuous) 离散 模块 (discrete) 

逻辑 和 位 操作 模块 (logic and bit operations) 查找 表 模 块 (lookup tables) 

数学 运算 模块 (math operations) 模型 验证 模块 (model verificationy》 

模型 实用 模块 (model 一 wide utilities) 端口 与 子 系 统 模块 (ports 以 subsystems) 
信和 号 属性 模块 (signal attributes) 信号 路 由 模块 (signal routing) 

接收 器 模块 (sinks) 源 模块 (sources) 

用 户 自 定义 模块 (user - defined functions) 附加 操作 模块 (additional math & discrete) 


下 面 将 详细 介绍 几 种 使 用 频率 较 高 的 模块 库 。 


1. 常用 模块 库 {(commonly used block ) 
常用 模块 库 中 的 模块 是 simulink 所 有 模块 库 中 使 用 频率 最 高 模块 的 合集 ,主要 是 为 了 方 
便 用 户 以 最 快 的 速度 建立 模型 。 常 用 模块 包含 图 2. 1. 3 所 示 的 成 员 ,模块 功能 如 表 2. 1. 2 


所 列 。 
K Ts 
Z-1 
Bus Creator Bus Selector Constant Data Type Demux Discrete-Time Gain 
Conversion Integratcr 
恒生 | KKCD | 业 ] 
Ground Int Integrator Logical Operator Mubx Dut1 Product 
| 避 ] :人 | 
Relationasl Saturation Scope Subsystermn Su Switch Terminatoe 
Operatcr 
Unit Delay 


2.1.3 常用 模块 库 


三 55 有 号 海 
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表 2.1.2 常用 模块 库 列表 


到 分 让 癌 


Logical Operator 逻辑 运算 将 输入 信号 合成 为 向 量 


标量 和 非 标量 乘除 或 抵 
OD 口 | 
下 wear 对 输入 作 关 系 运算 | saomim 人 狗 和 


Subsystem,Atomic Subsys- 
Scope and Floating Scope 显示 仿真 信和 号 tem，Nonvitual Subsystem， 
CodeReuse Subsystem 


Sum， Add， Subtract， 加 或 减 通过 第 二 个 输 人 值 来 输 
Sum ofElements 出 第 一 或 第 二 个 输入 
Tanaiaaos 终止 未 连接 的 输出 品 延迟 一 个 采样 周期 


2. 连续 模块 库 (continuous ) 


连续 模块 库 中 的 模块 如 图 2. 1.4 所 示 , 它 包含 了 搭建 连续 系统 所 涉及 的 绝 大 部 分 模块 ,这 
些 模块 的 功能 如 表 2. 1. 3 所 列 。 


duljdt = 人 U 人 了 
S sS2 dx s2 /dx 
Derivative 


Integratcr Integratcr Lirnited Integratct Secord-Crder Integrator Second-OCrder 
Lirmited 






以 子 系统 表示 其 他 系统 





Ref 9 一 1 
Plpe) X =Ax+BU 人 、 
y= Cx+Du S+1 
PID Controller PID Controlier {2DOF) State-Space Transier Fcn Transpecrt Delay 
(S1) 
To 以 上 Ti slsr1) 
Variable Tirme Delay Variable Transport Delay Zerco-Pole 


图 2.1.4 连续 模块 库 


本 = 基于 模型 的 设计 一 一 MCU 篇 


表 2.1.3 连续 模块 库 列表 


Iontegrator 2Lorder Limieed 比例 微 积分 控制 颖 
RU 零 极点 | 


结合 本 书 是 讲述 基于 模型 设计 的 思想 开发 MCU 器 件 ,本 章 将 以 Simulink 在 控制 电动 机 
中 的 应 用 为 例 , 介 绍 Simulink 的 建 模 与 调试 技术 。 这 里 值得 一 提 的 是 PID 控制 模块 。PID 控 
制 器 就 是 根据 系统 的 误差 ,利用 比例 .积分 .微分 计算 出 控制 量 进行 控制 的 。 它 是 在 较 新 版 本 
的 Simulink 中 才 新 增 并 逐步 完善 的 一 个 模块 ,R2010b 版 已 经 具备 自动 调节 功能 。 具 体 原 理 
和 使 用 将 在 后 面 分 析 。 


3。 离 散 模 块 库 (discontinuous ) 


离散 模块 在 涉及 数字 信和 号 系统 中 被 广泛 使 用 ,基于 这 种 考虑 ,mathworks 公司 单独 列 出 
了 离散 系统 模块 库 。 离 散 模 块 库 中 的 模块 和 其 功能 如 图 2.1.5 所 示 。 


他 


Ceuiermb & Visccuf Dead Zone Dynamic 1 Crossing 


Fnicticn 


UP 

il 本 二 后 六 | 
io 

Quantizer R Relay 


308 Lirniter RateLimiter Dynamic Saturation 


图 2.1.5 离散 模块 库 


其 中 常用 模块 的 功能 如 表 2. 1.4 所 列 。 
表 2.1.4 离散 模块 库 列表 


友 | 
} 


Discrete Filter 
















离散 微分 方程 
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续 表 2. 1.4 


Di te PID Controll 离散 双 自 由 度 PID 控 
Discrete PID Controller | 离散 PID 控制 器 RN mtrouer 
(2DOF) 制 器 


国 汪 了 
Discrete Zero-Pole 离散 时 间 积 分 
Te 传递 函数 (超前 或 延迟 ) 


4. 数学 运算 模块 库 (math operations ) 


数学 运算 模块 将 很 多 数学 运算 封装 成 模块 的 形式 ,使 数学 运算 操作 大 大 简化 ,减少 了 很 多 
程序 设计 上 的 烦琐 过 程 。 此 模块 库 所 包含 的 模块 如 图 2. 1.6 所 示 。 


三 RE | | | 二 [~ 
上 下 闪 关 Find 六 和 
Le | ER 一 






































Complez lo Divde Dot Produwdt Find Nonzero Gevn 
Constraint ReehHimag Elenene 
1 1 一 一 一 -- aa 区 民 下 
本 | | | 1 
机 ed X in 上 基 “ ] 时 3 
L-/ 证 LE: | 受 Im 一 有 
MagGnitde-Angi Math Function Mar WirMax MinMax Ronning Permwre Pododct Product of Reel-imeg to Reciprocal Sqrt 
全 人 Compiex Concaten st 有 Rey 针 让 吕 | 全 Dimensiors Elements Complex 
六 叶 PP [R ] FF ea 中 AP 民 
和 ) 站 Or , 才 b 闪 Vjui 半 玉 四 站 1 池 4Vup 内 queez 中 _ X+， 站 站 
J 人 局 本 nn ee JR 
内 站 革 PA Rounding Sign Snea 5Sqr Sine Wave Slider Gain Saqnm Saqueeze Subes 芝 Sum Suom of 日 ermmens 
Funcaoen Funchecn 
ee ee 用 
并 Sn 放 外 苹 上 办 yuU+Ts》> 
Tngonometnc Unary Minws Yector Weghteac SampP- 
Funelien Concetenate le Time inath 


图 2.1.6 数学 运算 模块 库 
其 中 常用 模块 的 功能 如 表 2. 1. 5 所 列 。 
表 2.1.5 数学 运算 模块 库 列 表 

本 
Su 对 输入 求 代数 和 取 整 
Gain 常量 增益 MinoMax “| 求 最 什 
Stider Gain 可 用 滑动 条 改变 的 增益 三 角 函 数 
YE 对 输入 求 积 或 商 强制 输入 信和 号 为 0 
Dot Product 复数 的 幅 值 相 角 
Sign 取 输 入 的 正 负 符 号 根据 幅 值 相 角 得 到 复数 
Abs 绝对 值 ( 模 ) 复数 的 实 部 虚 部 
RN 数学 运算 函数 由 实 部 虑 部 求 复数 


油 
绰 


党 
豆 


扣 


“41。 ; 
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S. 信号 源 模 块 库 {signal attributes ) 
信和 号 源 模块 库 如 图 2. 1.7 所 示 。 


是 对 日 辆 [ 王 二 


Band-Lirmited Chirp Si 间 nal Cloc Corastant Counter Free- Counter Limited Digital Cloc Enumerated 


White Noise Running Constant 
From File From Workspace Ground In1 Pulse Generator Ramp Random Nurmber Repesating 
Sequence 


则 畦 区 村 有 品 岂 


Repesting Sequ- Repeating Signal Builder Signal Generatcoe Sine Wave Uniform Random 
ence Interpolat.，、 Sequence Steir Number 


图 2.1.7 信号 源 模 块 库 


其 中 常用 模块 的 功能 如 表 2. 1.6 所 列 。 
表 2.1.6 信号 源 模块 库 列 表 


Band - Limited White Noise 频率 变化 的 正弦 信和 号 
Enumerated Constant 从 文件 读数 据 
Repeating Sequence 重复 序列 反 值 
polated 
蔡 信 号 


6. 信号 接收 模块 库 (sinks) 


信和 号 接收 模块 库 如 图 2. 1. 8 所 示 。 
其 中 常用 模块 的 功能 如 表 2.1.7 所 列 。 


全国 “一 一 一 


| 器 | 攻 全 | 生 人 伯 | 咎 | 习 > 
Display 


Flcasting Scope Out1 Scope Stop Simulation Terminatcr Te File 


图 2.1.8 信号 接收 模块 库 
表 2.1.7 信号 接收 模块 库 列 表 


TREE 天 学 时 停 上 仿真 


7. 用 户 自 定义 模块 库 (user-defined functions) 
用 户 自 定义 模块 库 如 图 2. 1. 9 所 示 。 


全套 T LE 日 
地 Sn 了 U ] 本 ) 本 本 
| 一 | 
Fcn 


Embedded MAT- Level-2 M-file S- NMIATLAE Fcn S-Function S-Functien S-Function 
LAB Function Funection Builder Exarmples 





图 2.1.9 用 户 自 定义 模块 库 


其 中 常用 模块 的 功能 如 表 2. 1. 8 所 列 。 
表 2.1.8 用 户 自 定义 模块 库 列 表 


Embedded MATLAB Function | 嵌入 式 MATLAB 函数 FEm 各 种 函数 组 合 
Level-2 M-File S-Funetion 使 用 MATLAB 函数 作为 输入 
S -Function S 孙 数 构造 器 


2.1.3 模块 的 基本 操作 


1， 模块 的 查找 
在 模块 库 页 面 的 左 侧 以 树 形 结构 显示 了 一 系列 的 子 库 , 如 连续 模块 库 、 离 散 模 块 库 、 数 学 
运算 模块 库 , 当 用 户 对 这 些 模块 比较 熟悉 以 后 ,可 以 非常 方便 .快捷 地 找到 自己 需要 的 模块 。 
”如 果 是 刚刚 接触 Simulink 的 用 户 , 这 里 还 提供 了 查找 功能 ,方便 不 熟悉 它 的 用 户 使 用 。 


伪 


“ 悦 
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如 图 2. 1. 10 所 示 。 

当 用 户 找 到 自己 所 需要 的 模块 后 ,就 要 把 它 复制 到 模型 编辑 窗口 中 以 便 进 行 下 一 步 的 操 
作 。 这 里 可 以 直接 把 模块 拖 搜 到 编辑 窗口 中 完成 复制 ,也 可 以 右 击 , 在 弹出 右键 菜单 中 选择 
Add to new model 命令 ,如 图 2.1.11 所 示 。 





哆 Simuliink HUbrarmy Browser 
| Fie Edik Wew Help 




















人 | earmaacrars es | 
苹 Simutink Library Browser [一 | 日 口 咏 台 外 Entersearchierm 了 | 遇 言 
| Sie Ed View Help | |Liarares | Larary Simumiucontinuous | Sesrch Resul 
| ER 上 二- 世 Smomh (Re < 

F | | 旧 让 和 
口 碎 Enter search term 7| 冲 咯 / 三 | | [Commonly Used 8 ] | 4 | Cerivstive 
| Contbnua ee 
[Libranes LibfaryY SeruinkiContinuous | 4 | | | ! 0 
| | 一 -| 一 | 六 Dieconhnufhes | as 
8GS /人 Derivative | | 
| aa 日 oscre Ad 隐 a new masiet Et | 
adicausn 赂 -ar uk 的 和 | 上 dg Bt Opersim ] 
os 三] | 。 :Help forthe integratorblcck | 
| | 一 Inlegratce | DuP Tab _ | 
| 一 Discontinuttes | 。。 | -Math Dperations | oo to Parent | 
iDlscrele 一 -一 Model Verficatm | | | 
-1 nmir sn ph mmnareahinme 了 1 4) | Mod de Ut 村 | | 1 
| Showin0: SmwuinkwContnuwcus Showan9 SmuinkContimucous | 
ae Cao 和 和 和 下 2 - 4 
2.1.10 模块 查找 图 2.1.11 添加 模块 


2. 模块 的 选 定 
模块 被 加 入 到 编辑 窗口 以 后 ,要 通过 选 定 模块 才能 对 其 进行 操作 。 选 定单 个 模块 可 以 直 
接 单 击 目 标 模 块 ; 也 可 以 按 住 鼠 标 任 意 键 拖 动 ,此 时 会 出 现 一 个 虚线 框 , 当 虚线 框 包 围 了 目标 
模块 时 松 开 鼠标 , 即 可 选中 模块 。 
若是 要 选中 多 个 模块 就 需要 用 上 述 的 虚线 框 法 来 操作 ,如 图 2. 1. 12 所 示 。 选 择 编辑 窗口 
中 所 有 对 象 的 方法 是 单 击 菜单 Edit-~>Select All 命令 。 


上 
rr 一 oomoowororeory 


图 2.1.12 选 定 一 组 对 象 


3. 模块 的 连接 和 调整 
《1) 模块 的 调整 。 为 了 使 模型 更 加 美观 和 符合 逻辑 ,有 时 需要 对 模块 的 大 小 ,方向 等 作 适 
当 的 修改 。 模 块 大 小 的 调整 。 选 中 模块 ,用 鼠标 选中 模块 周围 4 个 黑 
色 方 块 中 的 任意 一 个 开始 拖 动 ,这 时 会 出 现 一 个 虚线 框 表 示 的 新 模块 
大 小 示意 ,调整 至 需要 的 大 小 后 松 开 鼠标 即 可 ,如 图 2. 1. 13 所 示 。 
can 岂 模块 的 旋转 。 选 中 模块 想 要 旋转 的 模块 ,在 菜单 中 选择 Format 
2.1.13 调整 模块 大 小 命令 ,在 次 级 目录 中 选择 Flip Block 命令 可 以 使 模块 180 旋转 ;选择 
Rotate Block 使 模块 旋转 90"。 如 图 2. 1. 14 所 示 。 
《2) 模块 的 连接 。 模 型 中 的 信号 是 从 模块 经 连 线 传 输 到 下 一 个 模块 的 ,因此 模块 间 的 连 线 被 称 
为 信号 线 , 当 模块 设置 好 以 后 ,只 有 将 它们 按 一 定 的 顺序 连接 起 来 才能 完成 一 个 正确 的 模型 。 


> 
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吉 
人 Gain 下 nn | 
Fip Name 
图 2.1.14 模块 翻转 


@ 自动 连 线 :Simulink 系统 具备 自动 连 线 的 功能 ,步骤 如 下 :选择 一 个 具有 信和 号 输出 的 模 
块 , 按 Ctrl 键 , 然 后 单 击 要 连接 到 的 模块 ,如 图 2. 1. 15 所 示 。 

@ 手动 连 线 : 用 户 也 可 以 选择 自己 手动 连 线 。 把 鼠标 指针 移动 到 第 一 个 模块 的 输出 端 
口 , 这 时 鼠标 指针 的 形状 会 变 为 一 个 十 字 , 如 图 2. 1. 16 所 示 。 


于 一 加 友人 百 


Step SteP SocoPe 





图 2.1.15 自动 连 线 图 2.1.16 手动 连 线 


按 下 并 拖 动 鼠标 至 目标 模块 的 输入 端口 处 ,这 时 鼠标 指针 会 变 成 一 个 双 十 字 , 松 开 鼠 标 后 
两 个 模块 就 连接 起 来 了 ,如 图 2. 1. 17 所 示 。 

提示 :用 手动 方法 连接 模块 时 是 可 以 从 输出 到 输入 口 画 连接 线 的 。 

@) 分 支 连 线 :是 指 从 一 条 已 经 存在 的 连 线 上 另外 再 拉 出 一 条 线 用 来 连接 一 个 模块 的 输入 
口 。 这 时 , 原 连 线 和 分 支 连 线 上 传输 的 是 同一 个 信和 号。 

把 鼠标 指针 移动 到 原 有 连 线 上 , 按 Ctrl 键 , 拖 动 鼠 标 ,使 鼠标 指针 到 目标 模块 的 端口 , 松 
开 鼠 标 , 完 成 连 线 , 如 图 2. 1. 18 所 示 。 


是 局 
Step Scope 
-一 -此 > 
Step Scope Gain 
图 2.1.17 手动 连 线 2.1.18 分 支 连 线 


申 移动 连 线 : 把 鼠标 指针 移动 到 想 要 移动 的 连 线 处 , 按 住 鼠 标 左 键 并 拖 动 ,使 鼠标 指针 到 
目标 位 置 , 松 开 鼠 标 , 完 成 移动 ,如 图 2. 1. 19 所 示 。 

@ 连 线 的 折 曲 :选择 要 折 曲 的 线段 ,将 鼠标 指针 移动 到 要 折 曲 的 点 上 , 按 shift 键 , 并 按 住 
鼠标 左 键 , 这 时 鼠标 指针 会 变 成 一 个 圆圈 状 , 移 动 折 曲 点 至 目标 位 置 后 松 开 鼠标 ,完成 折 曲 。 
如 图 2. 1. 20 所 示 。 

@ 连 线 中 插入 模块 :如 果 模 块 只 有 一 个 输入 口 和 输出 口 , 那 么 可 以 将 该 模块 直接 插 人 到 
一 天 连 线 中 ,如 图 2.1. 21 所 示 。 

@O) 连 线 的 注释 :有 时 为 了 增加 模型 的 可 读 性 ,常常 会 给 信和 号 线 加 上 注释 。 在 要 添加 注释 
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的 连 线 附近 双击 会 出 现 一 个 文本 输入 框 ,用户 可 以 根据 需要 添加 适当 的 注释 ,注释 的 位 置 是 可 
以 通过 鼠标 拖 搜 更 改 位 置 的 ,如 图 2. 1. 22 所 示 。 





Step Scope 
全 ain 人 ain 
2.1.19 移动 连 线 图 2.1.20 曲折 连 线 





图 2.1.21 连 线 中 揪 入 模块 图 2.1.22 连 线 的 注释 


2 2 搭建 直流 电动 机 模型 


ME RAT SITE RN 了 OpeneAPe 


直流 电动 机 是 控制 系统 中 的 常用 组 件 , 它 给 系统 提供 旋转 动力 或 者 和 其 他 组 件 配合 进行 
传动 。 下 面 将 通过 一 个 直流 电动 机 模型 (DC Motor) 来 介绍 如 何在 Simulink 中 建立 LTICLin- 
ear time-invariant) 系 统 并 实现 对 其 转速 的 控制 。 


2.2.1 数学 模型 分 析 


电动 机 可 分 为 电气 部 件 和 机 械 部 件 两 部 分 ,电动 机 模型 如 图 2. 2. 1 所 示 。 










尺 
2 
和 L Viscous 
上 0 Friction 
vintb | 
委 1 | 
Inertial 1 
 Vemf 节 DC Meoter LoadJ | | 
Motor \ / / 
Torque Angular 
Velocity 


图 2.2.1 电动 机 模型 
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电动 机 的 电气 部 分 和 机 械 部 分 是 通过 转子 联系 起 来 的 ,转子 即 为 电能 与 机 械 能 转化 的 枢 
纽 。 这 两 部 分 的 方程 都 要 受到 转子 感应 电动 势 的 影响 。 

对 于 左边 的 电气 部 分 ,由 电 破 感应 定律 可 知 , 转 子 会 产生 一 个 反 向 的 感应 电动 势 来 阻止 转 
子 的 运转 ,外 界 电源 Vs 要 克服 反 向 感应 电动 势 做 功 ,才能 使 转子 转动 。 我 们 可 以 先 把 其 他 元 
件 抽象 为 电阻 和 电感 ,把 精力 集中 到 主要 矛盾 上 来 :电动 机 如 何平 稳 运 转 。 

当 电动 机 正常 运转 时 , 先 分 析 电气 部 分 回路 :外 部 电源 Vw、 电 阻 和 电感 上 的 电压 降 Vs 和 
Vi .转子 上 的 反 向 感应 电动 势 Ve 在 同一 个 回路 中 。 由 电路 分 析 的 基础 知识 KVL 定律 ( 基 尔 
黎 夫 电压 定律 ) 可 以 得 到 

Vu 一 VR 十 VL 十 Ver (2-1) 

对 于 右边 的 机 械 部 分 , 稍 复杂 一 些 。 当 电动 机 带 着 负载 匀速 旋转 时 ,其 输出 转 矩 必定 与 负 
载 转 矩 相等 。 在 非 理想 电动 机 模型 中 ( 即 不 忽略 机 械 、 电 磁 损耗 ) ,轴承 的 摩 氛 , 电 剧 和 换 向 器 
的 摩擦. 转子 铁心 中 的 涡流 、 磁 计 损耗 都 要 引起 阻 转 矩 。 此 阻 转 矩 用 Ti 表示 。 这 样 , 电 动机 的 
输出 转 矩 便 等 于 电磁 转 矩 了 减 去 电动 机 本 身 的 阻 转 矩 T!。 所 以 , 当 电动 机 克服 负载 阻 转 矩 
Ti 匀速 旋转 时 , 则 有 ， 

国 一 To 十 工 一 开 《2 一 2) 

实际 上 ,电动 机 经 常 运行 在 转速 变化 的 情况 下 ,例如 启动 . 停 转 或 反 转 等 ,因此 必须 讨论 转 
速 改变 时 的 转 矩 平衡 关系 。 当 电动 机 的 转速 改变 时 ,由 于 电动 机 及 负载 具有 转动 惯量 ,将 产生 
惯性 转 矩 刀 , 则 有 厂 =JX 锯 。 其 中 了 是 负载 和 电动 机 的 转动 惯量 ,w 是 电动 机 的 角速度 , 
是 其 角 加 速度 。 

为 了 使 模型 能 覆盖 这 种 更 一 般 的 情况 ,可 根据 牛顿 力学 定律 对 式 (2 - 2) 做 一 些微 调 ， 


To-- 环 = 了 =Jx 宇 (2 一 3) 


得 到 表示 电动 机 基本 原理 的 方程 后 ,需要 设置 一 些 参数 以 备 建 模 使 用 。 如 :电阻 尺 , 电 感 
了 ,转动 惯量 J, 转 算 Tu ,旋转 角度 0, 转 失常 量 人 ,感应 电动 势 常量 玉 .-, 粘 滞 摩 扩 因 数 天。 


因为 w(i= 王 0,V 一 Ko 人 bb, 式 (2-1) 可 化 为 ; 


于 十 Ri 一 Vs 一 Vi (2-4) 


又 因为 一 健 , 式 (2- 3) 可 化 为 : 


JX 0 十 Kb 一 T。 (2 -5) 
将 式 (2 -4). 式 (2 -5) 两 式 子 用 电压 Vi 和 转子 角速度 w 表示 出 来 可 写 为 : 
dj Via(b 一 Ri(b 一 玖 or 人 (1 
dt 于 
do 天 it 一 天 row 人 t) 
di 阳 
为 了 表示 方便 ,对 上 式 做 拉 普 拉 斯 变换 ,转换 到 S 域 。 
根据 拉 普 拉 斯 变换 的 规则 ,在 0 初始 条 件 下 ,一 阶 导数 -~s; 二 阶 导 数 -? , 则 可 得 到 : 


一 站 全 一 一 古 ec (2 -8) 


Rb) 


(2 二 < 


Ts) 
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天，T(s) 一 下 rwf(3S) 


了 (2 一 9) 


w(3s) 一 


合并 化 简 后 得 到 系统 传输 函数 : 


co(C5)》 天 。 
Vio(s) JJLY 十 (天 江 十 JR)s 十 (KR 十 多。 天) 


至 此 ,分 析 了 直流 电动 机 的 传递 函数 ,下 面 将 利用 Simulink 建立 直流 电动 机 模型 。 


2.2.2 模型 搭建 与 参数 设置 


(2 -10) 





1. 模型 搭建 


直流 电动 机 的 模型 需要 用 到 source 库 中 的 step 模块 , sinks 库 中 的 scope 模块 ,math 
operations 库 中 的 add gain, 和 continuous 库 中 的 integrator。 

(1) 添加 source 库 中 的 step 模块 到 模型 中 ,如 图 2. 2. 2 所 示 。 

默认 情况 下 ,信号 从 第 一 秒 处 产生 路 变 。 

《2) 添加 sinks 库 中 的 scope 模块 到 模型 中 ,如 图 2. 2. 3 所 示 。 


| Fle Edk View Help 


口 咏 | Entersearchterm 了 ] 制 吉 | 


[Pu Edie View Hep 


[Leranes Library Simulink'Sources | 路 





| Math Operatons 


| 
| 抽 Math Dperatons 
上 Model Verifhcabon 


| 一 NodelVerification 
导 | 一 NodeHWide Utiies | 


寺 =ModeFWide Utilities | | 
| Ports& Subsystems | 楼 、 月 | -Ports& Subsystems | 
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盖 Signai Routng | 盖 Signal Routing 
Smks Step | Smks 
| 国生 十 Sources | 六 Sources 
| User-Defned Functions 上 User-Defned Functions 


+-Additonal Math sa Dascrete 
让 = 器 Aerospace 5leckset 
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vagaa 一 








+-Addional Math & Dacrete 

骨 +*- 熏 Aerospace Biockset 

人 着 了 Communicatons Biockset 避 

ee 了 j _ RE 


图 2.2.2 step 模块 图 2.2.3 scope 模块 


示波器 模块 是 可 以 同时 显示 多 个 输入 信号 的 。 例 如 ,双击 打开 示波器 模块 , 单 击 按钮 加 
在 number of axes 中 输入 参数 3 即 可 使 示波器 变 为 3 个 输入 口 ,如 图 2. 2.4 所 示 。 

(3) 添加 math operations 库 中 的 add 模块 到 模型 中 ,如 图 2. 2.5 所 示 。 
FE 二 | 5le Ed Yew Hetp 


轴 'Scope' Parameters 






省 “48 人 










| General| Data History | Tip- try right cicking on axes 
} 俯 agemaeaueeatmearaana 和 or aaavas caasaoa eininaigaiigiiuniniiindiiiiimaa 


Axes | 


[Ge 一 rw | 
Te range: Puo | 








图 2.2.4 设置 scope 模块 
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图 2.2.5 add 模块 
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为 了 正确 表达 电动 机 模型 的 系统 方程 ,需要 两 个 Add 模块 ,其 符号 参数 List of signs 需要 
分 别 设置 为 “十 一 一 "和 “十 一 ”, 这 样 Add 模块 会 分 别 含有 2 个 和 3 个 输入 接口 。 如 图 2. 2.6 
所 示 。 
(4) 添加 math operations 库 中 的 gain 模块 到 模型 中 ,如 图 2. 2. 7 所 示 。 
| Ble_ Edit Wew gelp 


| 口 莹 ”> | Enter search term | 的 3 


Tary': SimulnkMath Operations 14 | | 





Commonly Used Biocks 
Continuous 





Fiain] Sigral Attributes |] 


Fomd 扩 Discontinutes 
Icon shape: |jroumnd | | -Decrete 


| [Lookup Tables 
Sample tinme (-1 for inherited): 


呈 】 


图 2.2.6 设置 add 模块 





| 国 oatn cperators 


| 一 Model Verification 


| | -ModehyWide Utilities 
|-Ports 5 Subsystems |u | 
| 一 SignalArrbutes 了 ZU 


图 2.2.7 ”gain 模块 





gain 模块 的 参数 需要 修改 。 该 模型 需要 6 个 gain 模块 ,参数 分 别 设 置 为 :1/L.Km、1/J、 
R 、Kf、.Kemf。 可 以 通过 双击 放大 器 模块 打开 其 参数 设置 页 面 ,然后 输入 参数 ,如 图 2. 2. 8 


所 示 。 


(5) 添加 continuous 库 中 的 integrator 模块 到 模型 中 ,如 图 2. 2.9 所 示 。 


ai Signal Attributes | Parameter Attributes j 
an 
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图 2.2.8 设置 gain 模块 
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图 2.2.9 integrator 模块 


模型 中 需要 两 个 Integrator 模块 ,参数 可 采用 默认 值 。 

(6) 按照 式 (2 - 10) 表 达 的 逻辑 ,在 第 一 个 积分 器 之 前 算 子 为 S ,其 系数 为 J 工 ;第 一 个 和 
第 二 个 积分 器 之 间 算 子 为 S, 其 系数 为 ( 开 寺 十 JR); 第 二 个 积分 器 之 后 算 子 为 1, 其 系数 为 
(天 尺 十 天 天 。)。 由 此 可 以 连接 其 中 的 各 个 模块 ,得 到 图 2. 2. 10 所 示 的 模型 。 

左 侧 的 模块 对 应 于 式 (2 - 8) ,其 输出 为 转 矩 Torque; 右 侧 的 模块 对 应 于 式 (2 - 9), 其 输出 
为 转速 w() 。 此 模型 实现 了 系统 传输 函数 所 描述 的 由 输入 电压 控制 直流 电动 机 转速 的 功能 。 
当 输 入 信和 号 为 Step 阶 婚 信号 时 ,输出 为 其 阶 牙 响应 ; 当 输 入 为 外 部 实际 控制 信号 时 ,电动 机 转 


- -- --- 一 -- a 9 


昧 5 基于 模型 的 设计 一 一 MCU 篇 


速 w(2 即 由 输入 信号 所 控制 。 





图 2.2.10 Simulink 电动 机 模型 


为 了 后 面 更 好 地 分 析 电 动机 模型 ,在 仿真 时 同时 输出 其 转动 控制 信号 和 输出 转速 ,角度 和 
转 矩 。 实 现 原理 如 下 : 

(1) 控制 信号 与 输出 转速 比较 在 添加 Signal Routing 库 中 的 Mux 模块 到 模型 中 , 如 
图 2. 2. 11 所 示 。 


| Ble Edt View Help 
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图 2.2.11 Mox 模块 
修改 模型 如 图 2. 2. 12 所 示 。 






hh; 
S 
Add1 Gain3 Integrator1 






图 2.2.12 Simulink 电动 机 模型 


《2) 转 和 矩 信号 输出 如 图 2. 2. 10 所 示 ,左边 框图 模块 组 的 输出 既是 转 和 矩 信 和 号。 
《3) 角度 信号 输出 由 电动 机 数学 模型 公式 
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(35) 天 。。 
Vs JJLs 十 (天 人 十 JR)s 十 (天 民 十 乓 天。) 


可 知 该 模型 的 输出 为 w(5), 即 旋转 角速度 , 且 0= | ww(z)dr, 因 此 ,模型 的 输出 经 过 一 个 
积分 器 即 转化 为 角度 ,修改 模型 如 图 2. 2. 13 所 示 。 


NID5 


ator 
Gain1 油 


Gain5 


(2 -11) 









图 2.2.13 Simulink 电动 机 模型 


2. 参数 设置 
最 后 ,在 仿真 之 前 一 定 要 设置 模型 仿真 参数 ,如 仿真 时 间 , 步 长 ,表达 式 中 定义 的 尺 工 J 
等 参数 值 等 。 


(1) 在 MATLAB 中 以 M 文件 或 命令 行 定义 变量 。 用 户 可 以 直接 在 MATLAB 命令 窗口 
中 输入 以 下 命令 ， 


>>R=2; 第 电阻 值 Resistor 
>>D=0.5; 外 电感 值 Inductor 
>> Km=0.1; $ 转 矩 常量 Torque Constant 


>> Kemf =0.1; 


>> Kf=0.2; 
>>UJ=0.02; 


外 反 电 动 势 常 量 Back EMF Voltage Constant 
咎 阻 滞 系 数 常 量 Viscous Friction Constant 
外 惯性 载荷 Inertial Load 


完成 后 ,在 MATLAB 工作 空间 中 可 以 看 到 这 些 变量 ,如 图 2. 2. 14 所 示 。 
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图 2.2.14 仿真 参数 设置 
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这 样 就 完成 了 模型 中 以 表达 式 形式 定义 的 参数 的 赋值 。 为 了 方便 以 后 再 次 运行 模型 ,可 


以 把 这 些 数 据 保存 下 来 ,在 运行 模型 之 前 装载 这 些 变量 即 可 。 
全 选 这 些 变量 , 单 击 按钮 临 , 输 入 保存 名 DC_motor( 用 户 可 自 定 义 ) ,扩展 名 为 . mat, 即 把 


数据 保存 到 了 当前 目录 下 ,以 后 可 以 通过 双击 直接 装载 变量 ,如 图 2. 2. 15 所 示 。 
当然 ,用户 也 可 以 将 上 述 命令 窗口 中 的 指令 保存 为 M 文件 的 形式 ,并 在 运行 模型 前 先 执 


行 M 文件 来 装载 变量 ,如 图 2. 2. 16 所 示 。 
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2.2. 16 


图 2.2.15 保存 参数 
(2) 在 Simulink 中 用 Annotation 方式 定义 变量 。 通 过 在 Simulink 中 定义 Annotation， 
可 以 直接 在 模型 编辑 窗口 中 完成 对 参数 的 赋值 ,而 不 必 再 从 MATLAB 中 读 取 , mat 文件 和 M 


文件 ,省 去 了 不 少 麻 烦 。 
在 模型 的 任意 空 日 处 双击 会 出 现 一 个 可 编辑 的 文本 框 , 写 人 相关 文字 , 如 Parameters 


Configuration。 如 图 2. 2.17 所 示 。 





Paremeters 
Seope 


图 2.2.17 添加 Annotation 


右 击 文本 框 会 弹出 右键 菜单 ,其 中 较为 有 用 的 有 如 下 几 项 命令 : 


由 Front. .. :调节 字体 字号 。 
@O Text Aligment: 文 本 对 齐 方式 。 
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G@ Hide/Show Drop Shadow :隐藏 /显示 阴影 。 


曲 Annotation Properties. . . 


G@ Foreground Color :前 景色 。 
@ Background Color: 背 景色 。 


Annotation :属性 设置 。 


选择 Foreground/Background Color 命令 调节 文本 框 的 颜色 ,选择 Show Drop Shadow 命 


令 显 示 文 本 框 阴 影 , 美 化 Annotation。 


选择 Annotation Properties. . . 


Annotation 命令 ,打开 其 设置 页 面 , 如 图 2.2.18 所 示 。 


在 ClikFcn 中 输入 上 文中 使 用 的 指令 , 单 击 OK 按钮 ,完成 了 Annotation 的 基本 设置 。 在 
后 重用 本 模型 时 ,只 要 单 击 该 文本 框 就 可 以 执行 对 模型 参数 的 赋值 ,如 图 2. 2. 19 所 示 。 
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2.2.18 设置 Annotation 


ClickFcn 


The ClickFcn is called when a User single-clicks on this 
armaotat1ion。 For exanple，tO brovwse 3 web Site speclified 
ln the armotatlon text tr7 

= getCallbackArmotation: webf(an. Text) : 
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KE=0. 2:; 
J=0.02 ; 


图 2.2.19 添加 Annotation 命令 


(3) Model Explorer。Model Explorer 能 够 快速 浏览 .批量 修改 模型 中 各 种 元 素 , 而 不 用 
再 在 图 形 或 表格 中 一 个 个 寻找 这 些 元 素 。 如 Simulink 模块 ,StateFlow 状态 图 ,MATLAB 工 


作 空 间 变 量 等 。 


人 人 Model 了 xplorer 别 面 ， 如 图 2. 2. 20 所 示 。 
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图 2.2.20 模型 浏览 器 
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基于 模型 的 设计 一 一 MCU 篇 


在 界面 中 间 的 Content Pane 里 列 出 了 模型 中 的 所 有 模块 和 变量 。 选 中 任意 模块 可 以 进 
行 修改 参数 ,数据 类 型 等 工作 ,该 模型 的 所 有 模块 设置 都 可 以 在 此 页 面 中 快速 完成 。 

更 详细 的 用 法 可 参考 帮助 文档 。 

(4) 设置 configuration Parameters 中 的 参数 。 在 simulation-~>configuration Parameters 
中 可 进行 更 多 的 设置 ,这 里 只 介绍 几 种 常用 的 设置 。 

@ 仿真 时 间 设 置 。 设 置 起 止 时 间 是 在 Start Time 和 Stop Time 的 文本 框 中 输入 相应 的 
数值 ,其 默认 值 分 别 为 0 和 10 ,单位 是 s, 如 图 2. 2. 21 所 示 。 


; Start timesi [00 Stop tiae; Po.0 


一 -一 一 一 一 一 一 = 。 -~-=-=-~ 二 -一 -- 一 -一 -一 


图 2.2.21 仿真 时 间 设 置 


Q@ 求解 器 步 长 设置 。 求 解 器 分 为 变 步 长 和 定 步 长 求解 器 ,一 般 情 况 下 可 采用 默认 的 auto 
设置 。 其 默认 值 为 :最 大 步 长 一 (停止 时 间 一 起 始 时 间 )/50 

如 果 是 高 级 用 户 , 则 可 作 进 一 步 设 置 。 步 长 是 求解 器 运算 时 的 时 间 精 度 , 步 长 越 短 , 精 度 
越 高 ,运算 量 也 更 大 。 

通过 下 面 的 例子 可 以 直观 地 看 到 步 长 对 仿真 结果 的 影响 。 

建立 图 2. 2. 22 所 示 的 模型 。 


Li [De 型 


Sine Wave Gain Scope 


图 2.2.22 求解 器 步 长 实验 模型 


在 Configuration Parameters 中 选择 使 用 定 步 长 求解 器 (Fixed-step), 如 图 2. 2. 23 所 示 ， 
则 当 步 长 (Fixed-step size) 分 别 选 择 1s 和 0.1s 时 的 仿真 结果 如 图 2. 2. 24 所 示 。 


Solver 0ptliomns 





] Solver:; fode3 (6ogacki-Shanpine) v] 


了 ixed-step size (fundamerntal sanple 七 ie); 


图 2.2.23 求解 器 设置 











图 2.2.24 仿真 结果 
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可 见 , 当 用 户 对 仿真 结果 的 精度 要 求 比 较 高 的 时 候 , 应 该 尽量 选择 小 步 长 求解 。 


(5) 运行 模型 。 单 击 工具 栏 上 的 按钮 "运行 仿真 ,双击 Scope 模块 即 可 查看 仿真 结果 ( 按 


下 按钮 幅 可 以 自动 调节 坐标 轴 到 合适 的 范围 ), 如 图 2. 2. 25 所 示 。 





图 2.2.25 电动 机 模型 仿真 结果 


在 示波器 Torque 中 可 见 转 和 矩 跟随 阶 信 号 的 趋势 变化 。 
在 示波器 Angle 中 可 见 ,转子 转动 过 的 角度 随时 间 变 化 基本 呈 线 性 增长 ,符合 其 与 记 () 


的 关系 0=- 上 多 
在 示波器 Speed 中 ,紫色 信号 表示 阶 牙 信 号 ;黄色 信和 号 为 系统 响应 ,在 接近 2 s 的 时 候 达 到 


稳定 状态 ,幅度 为 0. 25 左右 。 
为 了 更 进一步 分 析 此 系统 ,可 以 在 MATLAB 中 画 出 其 波 特 图 : 


>> DC_motor = tf([Km]j,[JxL(KtxL+JxR) (KfxR+KemnfxFKm)]); 负 生 成 电动 机 传输 函数 
>> bode(DC_motor) 负 生 成 波 特 图 


在 MATLAB 中 生成 图 2. 2. 26 所 示 波 特 图 。 








Frequency fradjsec) 


图 2.2.26 波 特 图 
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2.2.3 子 系统 与 库 


建立 子 系统 可 以 把 一 系列 的 模块 表示 为 一 个 子 系统 模块 ,大 大 简化 模型 的 复杂 度 ,其 具有 
以 下 突出 优点 :减少 编辑 窗口 中 模块 的 数量 ;可 以 把 功能 相关 联 的 模块 组 合 在 一 起 ;使 模型 具 
有 明确 的 功能 层次 。 

更 重要 的 是 在 子 系统 内 部 ,各 个 模块 被 认为 是 一 个 整体 ,这 样 一 来 ,其 运算 速度 和 信和 号 传 
递 速度 都 会 大 幅度 提高 ,是 对 模型 的 一 种 优化 。 


1. 建立 子 系统 


如 果 模 型 中 已 经 完全 包含 了 你 想 要 创建 的 子 系统 的 所 有 模块 ,可 以 通过 把 它们 组 合 起 来 
的 方式 建立 子 系统 。 
打开 电动 机 模型 , 选 定 想 要 包含 到 子 系统 中 的 所 有 模块 ,如 图 2. 2. 27 所 示 。 





图 2.2.27 选 定 模块 
单 击 Edit->Creat Subsystem 命令 。 选 定 的 模块 组 即 变 成 了 一 个 子 系统 模块 ,如 图 2. 2. 28 所 示 。 





图 2.2.28 创建 子 系统 
如 果 通 过 双击 打开 子 系统 , 可 以 看 到 子 系统 中 的 模块 组 合 逻 辑 ,如 图 2. 2. 29 所 示 。 





图 2.2.29 子 系统 内 部 结构 
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子 系统 外 部 接口 也 会 发 生 相 应 的 改变 ,可 按 图 2. 2. 30 所 示 方 式 连接 模型 。 





图 2.2.30 修改 连接 
用 户 也 可 以 先 创建 一 个 子 系统 模块 ,然后 在 子 系统 模块 中 完成 其 具体 的 组 合 逻辑 。 
从 模块 浏览 器 中 选择 Ports&Subsystems library-~>Subsystem。 通 过 双击 打开 子 系 统 模 
块 。 在 子 系统 中 完成 其 组 合 逻 辑 ,如 图 2. 2.31 所 示 。 
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2.2.31 Subsystem 模块 


2. 封装 子 系统 

将 子 系统 模块 重 命名 为 DC_motor_subsystem:, 方 便 以 后 使 用 。 右 击 子 系统 模块 ,在 弹出 
的 右键 菜单 中 选择 Mask Subsystem, 打 开封 装 编辑 器 。 

(1) Icon & Ports 选项 卡 。 在 该 页 面 的 Icon options 区 域 ,可 以 设置 模块 外 框 是 否 可 见 ， 
模块 是 否 透明 ,旋转 时 图 标 是 否 固定 或 跟随 模块 旋转 ,以 及 图 标 是 否 自 适应 模块 的 大 小 ,这 里 
均 采 用 默认 设置 。 

Icon Drawing Commands 区 域 中 可 以 用 命令 改变 模块 的 端口 名 称 , 添 加 图 像 ,修改 颜 色 
等 ,如 图 2.2. 32 所 示 。 

按照 界面 下 方 的 Example Drawing Commands 给 出 的 语法 格式 ,为 DC_motor_subsys- 
tem 添加 如 下 命令 : 


color( red ")) ;port_label(' input"，1，'Control Signal ); 


color( red ') ;port_label(" output "，1， 
color(' red ') ;port_label(' output "，2， 
color('red ) ;port_label(' output '，3， 
color(' red '") ;port_label(' output "， 


"Torque ); 
: Rngle ); 
“Step "); 


4，'Speed ') ; 


57 。 1 
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| 部 Mask Editor， DC_roeaic 306 光 ED 和 一 已- 属 而 ya 
icon & Ports ; Parameters Initialization | Documentation 
| Opticns ^ icon Drawming commands 
Block Frame 
Visible 
jcon Transparen 
ODpaaque 
| Icon Units 


Autoscale 


| Examples of drawing commands | 

| Command yort_ abal 口 shal spacitie yo5rts) 四 | 

| xy 
Syntax Port labeifCeutput , 工 xy) 


Unmask OK 上 canca | | Help j| Apply | 





图 2.2.32 Icon 人 Ports 选项 卡 
子 系统 的 端口 名 称 的 颜色 和 名 称 都 会 随 之 改变 ,如 图 2. 2. 33 所 示 。 





TI 
aoesr 


和 ER 





图 2.2.33 封装 后 的 模型 
添加 命令 image(Cimread( dianji. jpg ) ); 
会 将 当前 工作 目录 下 的 dianji jpg 图 像 文件 覆盖 到 模块 上 ,非常 直观 地 说 明 该 子 模块 的 
作用 如 图 2.2. 34 所 示 。 






DC_motor_subsystem 






TPReieS 
二 
加 本 近 | 哺 


dadpayX -cachaearsete 






图 2.2.34 封装 后 的 模型 


单 击 下 xample Drawing Commands 的 下 拉 菜 单 可 以 看 到 所 有 的 绘图 指令 和 语法 格式 ,用 
户 可 根据 需要 添加 相应 的 命令 。 
(2) Parameters 选项 卡 。 单 击 左 侧 工具 栏 按钮 :2## ,Dialog parameters 区 域 新 增 一 个 参数 


:和 和 四 一 二 
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设置 框 ,各 栏 的 功能 如 下 : 

@ Prompt: 人 参数 的 文字 撒 述 。 

@ Variable: 参 数 对 应 的 变量 名 。 

@@ Type: 参 数 的 输入 模式 ,edit 适用 于 需要 用 户 具体 指定 的 参数 。 

曲 Evaluate: 选 中 表示 在 参数 对 话 框 中 输入 表达 式 的 值 赋予 指定 的 变量 ,否则 将 输入 的 表 
达 式 看 作 字 符 串 赋予 指定 的 变量 。 

@ Tunable: 选 中 则 人 允许 用 户 在 仿真 过 程 中 修改 该 参数 值 。 

在 本 例 中 , 按 图 2. 2. 35 所 示 的 方案 设 定 参 数 。 
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图 2.2.35 Mask 参数 设置 界面 


单 击 OK 按钮 确认 后 , 若 双击 子 系统 模块 ,将 不 会 再 显示 子 系统 底层 结构 ,而 会 像 Simu- 
link 模块 库 中 自 带 的 模块 一 样 弹 出 参数 设置 界面 ,如 图 2. 2. 36 所 示 。 
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图 2.2.36 封装 后 的 参数 设置 界面 


一 一 
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封装 后 的 系统 参数 其 实 是 与 底层 模块 的 参数 相关 联 的 ,给 封装 系统 的 参数 赋值 就 相当 于 
给 定义 于 封装 工作 空间 中 的 参数 赋值 ,而 这 些 参数 与 底层 的 一 个 或 多 个 模块 相关 。 以 电阻 值 
R 和 力矩 常量 天 。 为 例 说明 封 装 参数 与 底层 模块 参数 间 的 关系 ,如 图 2. 2. 37 所 示 。 
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图 2.2.37 参数 传递 关系 
(3) Initialization 选项 卡 。Initialization commands 文本 框 用 于 输入 用 于 初始 化 该 模块 的 
MATLAB 命令 。 如 果 在 该 界面 中 输入 如 下 命令 ,同样 可 以 完成 参数 的 赋值 工作 ,如 图 2. 2. 38 
所 示 。 


本 za Th 


| Icon 有 ports | Parameters JInitialization | Documentation | 
| 
| 


| rDialog variables | Jnmialization commands 





图 2.2.38 Initialization 选项 卡 
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但 是 这 种 方式 应 慎 用 ,这 会 导致 上 文中 所 讲 的 Annotation `M 文件 等 赋值 方法 统统 失效 ， 
这 是 由 于 最 终 在 模块 执行 之 前 它 都 会 执行 此 初始 化 命令 ,将 参数 的 值 重 新 定义 为 初始 化 页 面 


中 设置 的 量 。 Icon && Ports] parameters | Initialization Documentation 
(4) Documentation 页 面 。 在 此 页 面 中 可 以 Naicngps horse 
注释 封装 的 类 型 .描述 .帮助 等 信息 。 0 


Mask descripton 


Q@ Mask type: 文 本 框 可 写 人 对 模块 的 简单 CR 
描述 。 re 

@ Mask description: 文本 框 用 于 详细 描述 ; Mask help 一- 一- 
模块 的 功能 。 

加 Mask help: 文 本 框 用 于 指定 模块 的 帮助 

















| OK j Camcel Help | Appljy | 





文档 。 umatk | 偿 : 
人 2. 2. 39 0 
砂 。 


2.2.4 添加 模块 到 库 浏览 器 及 知识 产权 保护 


在 设计 大 型 模型 时 ,通常 会 遇 到 多 次 重复 使 用 一 个 子 系统 模块 或 团队 的 其 他 成 员 需要 使 
用 用 户 所 搭建 的 子 系统 的 情况 ,用户 可 以 建立 自 定义 的 模块 库 并 添加 到 模块 浏览 器 中 ,将 这 些 
子 系统 归 类 整理 ,分 门 别 类 地 管理 ,便于 后 期 维护 与 利用 。 


1. 建立 自 定 义 模 块 库 并 添加 到 库 浏览 器 


(1) 建立 自 定 义 模 块 库 。 在 Simulink 库 浏 览 器 窗口 ,选择 菜单 项 File-~>New 一 Library, 打开 
库 编 辑 窗口 。 打 开 电 动机 模型 ,将 封装 后 的 子 系统 拖 人 库 编 辑 窗口 ,并 保存 为 DC_motor_ 
subsystem_lib。 如 图 2. 2. 40 所 示 。 
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图 2.2.40 建立 自 定 义 模块 库 
(2) 将 自 定义 模块 库 添加 到 库 浏 览 器 中 。 将 自 定义 模 块 库 添加 到 库 浏 览 器 中 ,可 以 在 以 
后 的 工作 中 更 方便 快捷 地 调用 。MATLAB 中 已 经 为 用 户 提供 了 添加 自 定 义 模块 库 的 相关 函 
数 ,用户 可 以 编写 以 下 M 函数 代码 ; 


function blkStruct = Slblocks 
blkStruct. Name = [DC_motor subsystem lib 门 ; 


可: 基于 模型 的 设计 一 一 MCU 篇 


2. 


的 底 
护 了 


命令 


底层 模块 ,如 图 2. 2. 44 所 示 。 


blkStruct. OpenFcn = “DC _motor_subsystem_ lib '; 
Browser(1).Library =“"“simulink '; Browser(1).Name = "Simulink '; 
Browser(1).IsFlat = 0; 

Browser(2).Library = “DC _motor_subsystem_ lib 

Browser(2). Name =“DC_motor_subsystem_1ib '; 

Browser(2).IsFlat = 0; 


将 其 保存 为 slblock. m 并 保存 到 DC _motor_subsystem_ lib. mdl 所 在 的 目录 下 ,如 图 2. 2. 41 所 示 。 
打开 模块 库 浏览 器 , 自 定义 的 模块 库 已 经 成 功 添 加 。 该 模块 可 以 直接 使 用 ,如 图 2. 2. 42 所 示 。 
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于 本 NI 了 -及 从， 


| | Name 
| 兄 DC_motorasy 
| 二] DC_mctorm 
困 DC_mocotormat 
| 呈 | DC_motormdl 
时 | DC_meotor_ FID.mdl 
虽 DC_metor_ MID_Maskedmdl | 

























图 2.2.41 M 文件 存储 路 径 图 2.2.42 ”添加 到 模块 库 浏 览 器 


知识 产权 保护 


有 时 用 户 需 要 把 自 定 义 的 模块 库 提 供给 别人 使 用 ,但 是 却 不 想 让 别人 看 到 或 修改 子 系统 
层 模 块 结构 。 通 过 以 下 设置 可 以 在 不 影响 使 用 的 条 件 下 禁止 他 人 访问 底层 模块 ,有 效 保 
用 户 的 个 人 资料 和 知识 产权 。 

(1) 在 将 封装 后 的 子 系统 拖 人 库 编 辑 窗口 之 前 右 击 子 系统 ,选择 subsystem parameters 
,如 图 2. 2. 43 所 示 。 

(2) 在 Read/Write Permissions 下 拉 菜 单 中 选择 NoReadOrWrite 命令 , 单 击 OK 确认 。 
(3) 将 子 系统 模块 拖 人 库 编 辑 窗口 。 

在 库 编 辑 窗 口中 右 击 模块 ,可 以 发 现 这 时 Look Under Mask 选项 变 成 了 灰色 ,禁止 访问 








人 Function Block Parameters: DC_motor_subsystem ”) 

| [ Subsystem RSIMESEIGESIDNMUnE 一 | 
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| -Parameters | 

Show port labels [FronPortIcon 吕 | 

Read/Write pernissions: [WoReadoryrite 本 

| ReadWrite | 1 

| | 人 
| Rane 吐 error callback f Readonly 下 Linear Analysis 
| 当 JRE SG 可 rit 了 | 上 
| Edit Mask 
| ; Pernit hierakchical resolutiors [1 es 四 | 

1 习 | took Under Mask 

f Treat as atonmic unit || Link Optiors 





DC_mmaotcr subsyst 


了 | Sian | 如 SC | own 
| cancel | en | uany | Re 


2.2.43 Block Parameters 界面 图 2.2.44 保护 后 的 模块 
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2.2.5 数据 格式 与 输入 /输出 


Sources 或 Sinks 子 库 中 的 现成 信号 源 或 输出 模块 可 能 不 能 满足 实际 应 用 ,因此 用 户 可 以 
根据 需要 选用 From Workspace 及 To Workspace 模块 ,自行 定义 模型 的 输入 及 输出 。 

用 户 可 以 通过 上 述 模块 导入 MATLAB 工作 空间 的 数据 ,也 可 以 把 输出 信号 保存 到 工作 
空间 。 这 项 功 让 用 户 能 够 使 用 由 标准 或 自 定义 的 MATLAB 函数 产生 的 数据 作为 输入 信和 号 和 
图 形 ,使 仿真 更 具 多 样 性 。 


1. 把 数据 导出 至 工作 空间 


(1) 新 建 一 个 演示 模型 ,向 模型 中 添加 sink 库 中 的 To Workspace 模块 ,该 模块 位 于 图 
2. 2. 45 所 示 的 位 置 。 

打开 To Workspace 模块 的 参数 设置 界面 ,其 中 Data 栏 显 示 的 simout 即 变量 名 ,用 户 可 
根据 需要 自行 更 改 。 

为 便于 From Workspace 访问 ,可 以 将 To Workspace 模块 的 save format 设置 为 Array， 
如 图 2. 2. 46 所 示 。 
是 seeespornRWp 了 须 国 
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| ine siaolation Using si cosaard the workspace 13 
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StructUre 
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ES 
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Addional Msih 5 Da< | f Log fixedpoint data as an fi object 
和 ~nmmnerahnrns nryawy 3 
Snowpng Smuinusnks 
图 2.2.45 simout 模块 图 2.2.46 设置 simonut 模块 


(2) 向 模型 中 添加 source 库 中 的 signal builder 模块 ,如 图 2. 2. 47 所 示 。 
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图 2.2.47 signal builder 模块 


村 ] 基于 模型 的 设计 一 MCU 篇 


打开 该 模块 的 设置 界面 ,用 户 可 以 方便 地 通过 其 GUI 界面 画 出 任意 需要 的 信号 波形 。 这 
里 画 出 一 个 从 第 3 s 起 持续 4 s 的 和 矩形 脉冲 ,如 图 2. 2. 48 所 示 。 关 于 该 模块 的 更 详细 用 法 不 
是 本 书 重 点 ,如 有 兴趣 可 参看 帮助 文档 。 
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图 2.2.48 信号 波形 
(3) 向 模型 中 添加 gain 模块 和 scope 模块 ,并 按 图 2. 2. 49 连接 模块 。 






To Workspace 


Scope 


图 2.2.49 向 工作 空间 传递 数据 
单 击 工具 栏 上 的 按钮 ， 运 行 仿 真 ,MATLAB 的 工作 空间 中 会 显示 变量 如 图 2. 2. 50 所 示 。 
示波器 中 显示 波形 如 图 2. 2. 51 所 示 。 
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图 2.2.50 工作 空间 的 数据 图 2.2.S1 仿真 波形 
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Simulink 仿真 中 的 数据 已 经 导入 了 工作 空间 ,用 户 可 以 根据 需要 对 这 些 数据 作 进 一 步 
处 理 。 
2， 从 工作 空间 导入 数据 
(1) 向 模型 中 添加 sources 库 中 的 From Workspace 模块 代替 signal builder, 即 可 用 于 从 
工作 空间 导 人 数据 ,该 模块 位 于 图 2. 2. 52 所 示 的 位 置 。 
打开 From Workspace 模块 的 参数 设置 界面 ,其 中 Data 栏 显示 的 simin 即 变量 名 ,用 户 可 
根据 需要 自行 更 改 , 如 图 2. 2. 53 所 示 。 
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2.2.52 simin 模块 图 2.2.5S3 simin 设置 


(2) 按 图 2. 2. 54 所 示 连 接 模块 。 






To Workspace 





Workspace 


Scope 


图 2.2.54 从 工作 空间 读数 据 


From Workspace 模块 调用 工作 空间 的 数据 时 ,是 遵循 严格 的 格式 的 ,一 般 是 矩阵 形式 ， 
而 且 输 入 矩阵 的 列 数 必 须 比 输入 信和 号 多 一 列 ,Simulink 会 自动 把 首 列 数据 当做 时 间 向 量 。 根 
据 此 规则 ,需要 在 工作 空间 内 生成 一 个 待 输入 信和 号 : 


>> simin = [tout simout]; 生 成 2 列 的 矩阵 
用 户 可 以 打开 workspace 中 的 变量 simin 查看 其 数据 存储 结构 ,如 图 2. 2. 55 所 示 。 
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| 于 simin <56x2 double> 
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图 2. 2.55 数据 存储 结构 
3. 实现 外 部 信号 对 电动 机 的 控制 


回 到 电动 机 模型 ,用 一 个 外 部 信号 替代 阶 既 信号 控制 电动 机 ,用 户 可 以 通过 这 个 外 部 信和 号 
实现 对 电机 转速 的 控制 。 

向 模型 中 添加 From Workspace 模块 替代 Step 模块 ,并 重 命 名 为 Vin_Control Signal , 如 
图 2. 2. 56 所 示 。 


Speed 









Scope 





图 2.2.56 添加 simin 模块 


这 里 的 From Workspace 模块 仍然 使 用 上 文中 生成 的 变量 simin 作为 控制 信号 ,Data 栏 
设置 变量 名 为 simin 即 变量 名 ,如 图 2.2.57 所 示 。 


运行 仿真 后 得 到 的 结果 如 图 2. 2. 58 所 示 。 
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图 2.2.S7 设置 simin 模块 图 2.2.58 仿真 结果 
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由 仿真 结果 可 知 , 系 统 响应 曲线 变化 的 总 体 趋势 是 跟随 控制 信号 相 吻 合 的 ,说 明 外 部 信号 
对 电动 机 转速 的 控制 是 有 一 定 效果 的 。 但 系统 响应 速度 还 不 理想 , 且 其 响应 幅度 远 远 没有 达 
到 控制 信号 的 要 求 , 需 要 通过 进一步 矫正 才能 符合 需要 。 


2.2.6 _PID 控制 


在 上 文 的 仿真 结果 中 可 以 看 到 :输出 电动 机 转速 w( 刀 只 是 大 体 上 跟随 控制 信号 的 变化 趋 
势 ,而 并 没有 严格 地 达到 控制 信号 所 要 求 的 转速 大 小 。 这 是 由 于 模型 还 缺少 一 个 反馈 控制 模 
块 ,PID 模块 能 很 好 的 完成 这 个 工作 。 

PID( 比 例 积 分 微分 ) 英 文 全 称 为 Proportion Integration Differentiation, 它 以 结构 简单 、. 稳 
定性 好 、 工 作 可 靠 .调整 方便 等 特点 成 为 工业 控制 的 主要 技术 之 一 。 

PID 控制 器 由 比例 部 分 ,积分 部 分 和 微分 部 分 构成 (图 2. 2. 59) 。 控 制 器 的 输入 端 是 被 控 
系统 的 控制 信号 与 被 控 量 间 的 误差 , 误 关 信 号 分 别 通过 比例 、 积 分、 微分 环节 ,并 与 相应 的 系数 
相 乘 ,输出 的 PID 控制 器 信号 即 为 这 3 个 部 分 输出 信号 之 和 ,最 终 PID 控制 器 输出 信号 与 原 
始 控制 信号 做 差 后 控制 被 控 量 ,最 终 形成 完整 的 反馈 回路 。 因 此 ,要 确定 一 个 PID 控制 器 只 
需要 确定 其 比例 、 积 分、 微分 的 系数 :天 ,天 ,天 ,如 图 2.2. 59 所 示 。 
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2.2.59 PID 控制 器 结构 


PID 控制 器 的 参数 设 定 是 控制 系 设 计 的 核心 内 容 , 但 是 传统 的 设计 方法 存在 不 少 缺 陷 ,在 
实际 应 用 中 会 遇 到 很 多 问题 ， 

(1) 传统 的 设计 方法 中 ,参数 氏 KK 的 设 定 主要 依赖 以 往 的 工程 经 验 , 对 控制 器 的 参 
数 进行 手动 调节 ,如果 以 前 的 项 目 中 有 过 类 似 的 控制 器 ,就 可 以 直接 在 控制 系统 硬件 上 进行 手 
动 微 调 ,这 样 工 作 量 很 小 。 但 如 果 被 控 对 象 是 一 个 不 稳定 系统 ,手动 调节 就 会 变 得 比较 复杂 ， 
因为 很 可 能 由 于 不 好 的 参数 设 定 和 控制 算法 ,使 系统 硬件 面临 烧毁 的 危险 。 

(2) 积分 饱和 现象 会 使 控制 品质 变 差 。 所 谓 积分 饱和 是 指 :对 于 具有 积分 运算 的 控制 器 ， 
只 要 系统 控制 信号 与 被 控 量 间 存 在 偏 益 ,PID 控制 器 的 输出 就 会 不 停 地 变化 来 矫正 偏差 ,但 是 
当 系 统 出 现 某 种 问题 导致 偏差 一 时 无 法 消除 时 ,控制 器 还 试图 矫正 这 个 偏差 ,这 样 经 过 一 段 时 
间 后 就 会 造成 控制 器 进入 深度 饱和 状态 。 进 人 积分 饱和 的 控制 器 只 有 等 被 控 量 偏差 反 向 后 才 
能 逐渐 消除 ,重新 恢复 控制 作用 。 因 此 ,在 涉及 控制 器 时 ,要 考虑 到 抗 积分 饱和 的 问题 。 

(3) 微分 近似 。 由 于 纯 微分 作用 在 实际 中 是 不 可 能 实现 的 ,设计 控制 器 时 就 要 考虑 如 何 
对 微分 进行 准确 地 近似 。 

(4) 在 设计 控制 器 时 ,经 常会 遇 到 无 法 确定 需要 使 用 哪 种 结构 的 问题 ,如 P、.PI.PD、PID; 
需要 确定 使 用 一 维 还 是 二 维 的 算法 ;需要 确定 是 否 需 要 输出 饱和 设置 ;需要 考虑 抗 积分 人 饱 和 特 


醒 : 基于 模型 的 设计 一 MCU 篇 


性 ;特别 是 系统 含有 两 个 以 上 控制 器 时 ,还 要 考虑 到 算法 切换 时 的 瞬 态 稳定 性 。 
(5) 如 果 要 把 PID 控制 器 算法 生成 代码 应 用 到 实际 系统 中 区 去 ,还 需要 对 算法 和 参数 做 


离散 化 ,定点 化 处 理 。 
使 用 PID 模块 ,可 以 很 好 地 解决 上 述 问 题 。 下 面 通过 为 上 文 提 到 的 直流 电动 机 模型 添加 


PID 控制 模块 介绍 其 使 用 方法 。 
打开 电动 机 模型 ,装载 变量 到 工作 空间 ,添加 math operations 库 中 的 Sum 模块 到 模型 


中 ,如 图 2. 2. 60 所 示 。 
双击 模块 打开 参数 设置 对 话 框 ,将 其 符号 设置 为 | 十 一 ,如 图 2. 2.61 所 示 。 
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图 2.2.60 Sum 模块 图 2.2.61 Sum 设置 


添加 continuous 库 中 的 PID 模块 到 模型 中 ,该 模块 位 于 图 2. 2. 62 所 示 的 库 中 。 
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图 2.2.62 PID 模块 
连接 模型 如 图 2. 2. 63 所 示 。 


Vin_Control Signal 


图 2.2.63 添加 PID、Sum 模块 
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1. 用 PID Tuner 设计 PID 控制 器 
双击 打开 PID 模块 的 设置 界面 ,如 图 2.2. 64 所 示 。 





CortrOTLLeF: jpm 和 
Time-domain; 
PIContimuous-tine | 
全 Discrete-tiae 


机 ai | PID Advanced }】 Data Types 】 State Attributes | 











Cortroller settirngs 

ContrOol1er form: [Parallei ago ascimee ee 一 一 Easy- 
Proportional (P): 三 55.8705815550258 os 

Fuel ti， 让 We 

Derivatiowe (D): 和 三 2.5757217066611 3 Filter coefficient (j): 54.1176208020410 


图 2.2.64 PID 模块 设置 页 面 


(1) Controller 通过 Controller 下 拉 菜 单 中 的 PI、PI、PD、PID 选项 轻松 地 切换 控制 器 的 
结构 模式 。 

(2) Time-domain 选项 可 以 快速 地 在 连续 域 和 离散 域 间 切 换 。 

(3) Controller Setting 选项 可 以 为 控制 器 选择 工作 状态 并行? 或 “理想 型 ?具体 区 别 可 参 
考 help 文件 。 

(4) PID Advanced 选项 卡 中 可 以 对 控制 器 做 一 些 高 级 设置 ,比如 输出 饱和 限制 , 抗 积 分 
饱和 特性 ,追踪 模式 等 ,如 图 2. 2. 65 所 示 。 
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图 2.2.65 PID Advanced 选项 卡 


(5) Limit output: 勾 选 复 选 框 使 能 输出 饱和 限制 。 

(6) Anti - windup method: 选 择 抗 积分 人 饱 和 模式 。 

(7) Enable tracking miode: 勾 选 复 选 框 使 能 追踪 模式 ,使 算法 切换 时 更 加 平滑 。 

下 面 是 最 重要 的 一 步 : 设 置 P.I、D 的 系数 。 传 统 的 手动 调节 法 不 仅 费时 费力 ,还 有 可 能 
对 系统 造成 破坏 ,并且 用 户 永远 不 知道 自己 设计 出 的 参数 是 否 为 最 优 。 

而 基于 规则 的 调节 法 无 法 应 用 于 开 环 的 不 稳定 系统 ,也 不 能 用 诗 高 阶 系 统 和 有 延迟 的 系 
统 , 且 对 用 户 的 控制 理论 背景 要 求 很 高 ,不 易 掌 握 。 


有 ,69 。 ， 
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Simulink 提供 了 一 个 全 新 的 GUI 调节 算法 可 以 方便 地 完成 这 些 复杂 的 工作 ,自动 调节 控 
制 器 参数 以 达到 所 期 望 的 性 能 指标 ,通过 简单 的 滚动 条 操作 完成 微调 的 功能 。 

单 击 参数 设置 页 面 上 Controller settings 中 的 Tune 按钮 打开 GUI 界面 ( 单 击 show pa- 
rameters 可 以 完整 地 显示 参数 ) ,如 图 2. 2. 66 所 示 。 
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图 2.2.66 PID 自动 调节 界面 


PID Tuner 会 自动 在 系统 默认 的 工作 点 处 对 模型 进行 线性 化 处 理 , 设 计 出 控制 器 的 参数 。 
用 户 可 以 直观 地 通过 GUI 界面 看 到 系统 的 响应 。 

界面 的 下 方 有 一 个 滚动 条 工具 ,通过 拖 动 滚动 条 可 以 调节 系统 的 响应 时 间 , 这 里 将 响应 时 
间 调 节 到 0. 0785s。 通 过 GUI 界面 可 以 看 到 系统 响应 速度 明显 提高 ,并 出 现 了 一 个 小 的 过 冲 。 

如 果 在 界面 上 方 的 Design mode 下 拉 菜 单 中 选择 extended 命令 ,会 出 现 额 外 两 个 滚动 条 
“带宽 2 和 "相位 裕 量 ”, 通 过 拖 动 它们 可 以 改变 系统 响应 的 快速 性 和 平稳 性 ,如 图 2.2.67 所 示 。 
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图 2.2.67 调节 滑 块 


在 显示 阶 既 响应 曲线 的 区 域内 右 击 ,根据 需要 选择 characteristics 中 的 一 项 或 几 项 ,会 在 
响应 曲线 上 添加 相应 的 蓝 点 来 表示 这 些 特征 点 : 

(1) Peak Response: 峰 值 。 

(2) Setting Time: 稳 定时 间 。 

(3) Rise Time: 啊 应 时 间 。 

(4) Steady State :稳定 状态 。 
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单 击 这 些 蓝 点 会 显示 其 详细 信息 ,如 图 2. 2. 68 所 示 。 
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图 2.2.68 定位 特征 点 
当 用 户 得 到 满意 的 响应 曲线 后 , 单 击 Apply 按钮 ,PID Tuner 自动 设计 的 参数 就 已 经 写 人 
到 了 参数 设置 框 中 ,如 图 2. 2. 69 所 示 。 


Comntroller settings 
Controller form: Parallel ES ES 
Proport ional (P) : 7.61876506172232 
Integral (I) : 32. 0768093880999 


Derivative (D): 0. 03885540903015234 Filter coefficient (HH): 23.3510675715948 


图 2.2.69  PID 参数 


运行 加 入 PID 控制 器 后 的 直流 电动 机 模型 。 可 以 看 到 ,响应 速度 得 到 了 很 大 提高 ,被 控 
量 转速 w(i) 基 本 上 已 经 和 控制 信号 Vi 基本 吻合 了 ,如 图 2. 2. 70 所 示 。 





图 2.2.70 PID 调节 后 的 仿真 结果 
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柄 : 基于 模型 的 设计 一 一 MCU 篇 


2. 用 波 特 图 法 设计 PID 控制 器 
Simulink 的 Control Design 工具 提供 了 更 多 设计 PID 控制 器 的 方法 。 这 里 以 波 特 图 设 
计 法 为 例 介绍 如 何 用 Control Design 工具 设计 PID 控制 器 。 
打开 添加 过 PID 模块 的 电动 机 模型 ,选择 Tools 一 Control Design-~>Compensatotf Design 
命令 打开 Control and Eatimation Tools Manager 窗口 。 选 择 Simulink Compensator Design 
Task 节点 , 单 击 Select Block 按钮 ,确定 将 要 调节 的 模块 ,如 图 2. 2.71 所 示 。 
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图 2.2.71 控制 与 估计 管理 工具 界面 
在 弹出 窗口 中 勾 选 Tune? 复 选 框 , 单 击 “ 确 定 ” 按 钮 ,如 图 2. 2. 72 所 示 。 
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图 2.2.72 选择 待 调节 的 目标 模块 
设计 PID 控制 器 前 ,要 先 为 系统 指定 需要 调节 的 闭环 系统 ,标识 其 输入 /输出 信号 。 在 
Vin_Control Signal 模块 后 的 信号 线 处 右 击 ,选择 Linearization points 一 Input Point 命令 ;在 DC _ 
motor_subsystem 模块 后 的 Speed 信号 线 处 右 击 ,选择 Linearization points 一 Output Point 命令 。 
这 将 在 信号 线 处 添加 上 + 和 二 ,它们 分 别 标识 该 闭环 的 输入 和 输出 ,如 图 2. 2. 73 所 示 。 
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图 2.2.73 标记 系统 输入 /输出 
在 Control and Estimation Tools Manager 中 单 击 Tune Blocks 打开 ER Configura- 
tion Wizard 对 话 框 ,直接 单 击 Next 按钮 ,开始 设置 。 
Wizard 的 第 一 步 是 选择 调节 控制 器 所 用 到 的 设计 图 形 , 这 里 使 用 其 默认 配置 并 单 击 


Next; 第 二 步 选 择 分 析 响 应 曲线 所 用 到 的 图 形 的 类 型 ,在 Analysis Plots 区 域 选 择 Step 作为 
图 形 类 型 ,在 Content in Plots 选项 区 域 中 勾 选 1 复 选 框 , 用 来 画 出 从 Vin_Control Signal 到 
DC _motor_subsystem 的 闭环 阶 既 啊 应 曲线 ,如 图 2. 2.74 所 示 。 
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图 2.2.74 设置 step 类 型 
单 击 Finish 按钮 退出 Wizard ,并 画 出 阶 妈 响 应 曲线 ,如 图 2. 2.75 所 示 。 
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这 时 还 会 弹出 一 个 空白 的 SISO Design for SISO Design Task 窗口 ,将 在 后 面 用 到 ,不 要 关闭 。 
在 Control andEstimation Tools Manager 的 SISO Design Task 节点 中 打开 Graphical 
Tuning 选项 卡 ,将 Plot Type 中 Plotl 的 类 型 设置 为 Open-Loop Bode。 如 图 2. 2. 76 所 示 。 
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图 2.2.76 设置 为 开 环 波 特 图 


完成 上 述 操作 后 单 击 Show Design Plot 按钮 ,在 SISO Design for SISO Design Task 窗口 
绘制 出 开 环 波 特 图 ,如 图 2. 2.77 所 示 。 
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图 2.2.77 调节 界面 


图 中 的 红色 的 圆圈 和 叉 均 可 用 鼠标 拖 动 ,曲线 形状 也 会 随 之 变化 ,同时 ,LTI Viewer for 
SISO Design Task 窗口 中 的 阶 妈 响 应 曲线 也 会 同步 更 新 。 例 如 , 增 大 波 特 图 中 的 增益 , 阶 婚 
响应 时 间 会 缩短 。 

使 用 与 PID Tuner 设计 PID 控制 器 法 相同 的 设置 方式 ,同样 可 以 显示 调节 得 到 的 阶 牙 响 
应 曲线 的 特征 点 数据 ,如 图 2. 2.78 所 示 。 

当 用 户 确 定 阶 牙 响应 曲线 符合 要 求 时 ,可 在 Control and Estimation Tools Manager 窗口 
的 SISO Design Task 节点 中 单 击 Update Simulink Block Parameters 按钮 。 这 样 ,设计 的 PID 
控制 器 参数 即 被 写 人 到 了 PID 模块 中 ,设计 过 程 完 成 。 
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图 2.2.78 定位 特征 点 
运行 模型 ,观察 电动 机 转速 啊 应 曲线 ,如 图 2. 2. 79 所 示 。 





图 2.2.79 调节 后 的 仿真 结果 


3。 离散 域 PID 控制 器 


要 把 控制 器 算法 应 用 到 实际 的 控制 器 中 ,还 需要 将 其 转化 到 离散 域 , 并 且 要 考虑 到 实际 处 
理 器 的 位 数 和 算法 是 否 吻 合 。 如 果 离 散 化 与 定点 化 做 得 不 好 ,很 可 能 导致 一 个 在 连续 域 性 能 
不 错 的 控制 器 转换 到 离散 域 , 定 点 化 后 完全 不 能 达到 设计 指标 。 

双击 用 上 文 方 法 设计 好 的 PID 模块 ,打开 其 设置 界面 ,在 Time Domain 选项 区 域 中 点 选 
Discrete-Time 单 选 按钮 ,采样 时 间 设 为 0. 1 s, 单 击 运行 模型 ,可 以 看 到 系统 已 经 变 得 不 稳定 
了 ,如 图 2. 2. 80 .图 2. 2. 81 所 示 。 


人 
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这 是 由 于 用 户 在 用 PID Tuner 设计 控制 器 时 ,为 控制 器 设置 的 带宽 为 25. 5 rad/s( 图 
2. 2. 82) ,将 其 除 以 2r 转化 为 4.11 Hz, 而 采样 带宽 为 10 Hz, 不 到 系统 带宽 的 3 倍 。 在 实际 工 
程 应 用 中 ,采样 带宽 应 该 为 系统 带宽 的 5 一 10 倍 ,可 根据 硬件 系统 的 采样 率 来 设置 。 这 里 假设 
按照 本 节 “1. 用 PID Tuner 设计 PID 控制 器 ?中 介 
绍 的 方法 调节 出 与 图 2. 2. 66 相似 的 响应 曲线 ,选择 正 xtended 模式 ,可 以 发 现 这 时 的 系统 带宽 
为 2.73 Hz, 采 样 带宽 是 系统 带宽 的 三 十 多 倍 , 单 击 “ 确 认 ? 按 钮 ,更 新 PID 参数 。 这 时 如 果 手 


为 0.01 s, 单 击 Tune 按钮 打开 PID Tuner。 
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2.2.80 设置 为 离散 PID 





2.2.81 仿真 结果 


本 na 如 图 2. 2. 82 所 未 
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图 2.2.82 PIpD 调节 界面 
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单 击 OK 确认 ,更 新 PID 参数 ,运行 模型 。 这 时 系统 再 次 变 得 稳定 了 ,如 图 2. 2. 83 所 示 。 


as 





Angle 有 


图 2.2.83 离散 PID 控制 后 的 仿真 结果 


2.3 _ Simulink 模型 调试 


Grainorv TAKE 


Simulink 为 用 户 提供 了 功能 强大 的 模型 调试 工具 :Simulink Debugger。 它 是 一 个 交互 式 
的 调试 Simulink 模型 的 工具 。 该 工具 可 以 设置 断 点 ,控制 仿真 的 执行 ,显示 模型 的 运行 信息 。 
通过 使 用 调试 器 ,用 户 可 以 一 步 一 步 地 仿真 模型 ,可 以 在 任意 步骤 处 单 步 运行 ,发 现 模型 中 可 
能 存在 的 问题 ,或 对 其 进行 修改 。 

Simulink Debugger 有 图 形 界面 (GUID) 和 命令 行 界面 两 种 运行 方式 :命令 行 界 面 模式 可 以 
实现 调试 器 的 所 有 功能 ,但 需要 用 户 事先 了 解 调 试 命令 ;图 形 用户 界 面 模 式 使 用 方便 简洁 ,可 
以 实现 调试 器 的 绝 大 部 分 功能 ,这 里 重点 介绍 图 形 用 户 界 面 模式 。 


2.3.1 图 形 界 面 调试 


1. 启动 调试 器 
图 形 界面 调试 器 可 以 通过 模型 编辑 窗口 中 的 Tools 一 Simulink Debugger 命令 启动 ,也 可 

以 通过 单 击 其 工具 栏 上 的 图 标 " 镶 "启动 。 调 试 央 界 面 如 图 2. 3. 1 所 示 。 
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图 2.3.1 调试 器 界面 
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2 图形 界 面 调试 器 介绍 


(1) 工具 栏 。 工 具 栏 位 于 调试 器 窗口 的 最 上 方 , 从 左 至 右 依 次 为 以 下 指令 :进入 当前 方 
法 、. 跳 过 当前 方法 .跳出 当前 方法 、 在 下 一 个 方法 开始 时 返回 第 一 个 方法 .开始 /继续 运行 仿真 、 
暂停 调试 .终止 调试 .在 选中 的 模块 前 设置 断 点 执行 时 显示 选中 模块 的 MO 信息 .显示 选中 
模块 的 当前 IO 信息 、 开 启 / 关 闭 动画 、 动 画 延 时 .帮助 信息 和 关闭 调试 器 ,如 图 2. 3. 2 所 示 。 

这 里 提 到 的 “方法 ?是 指 Simulink 在 仿真 过 程 中 逐 时 间 步 长 对 模型 求解 时 所 用 到 的 运算 
方法 。 其 实 每 一 个 模块 都 是 由 若干 个 这 样 的 “方法 ”构成 的 ,运行 模型 也 就 等 价 于 对 各 个 模块 
中 的 “方法 " 按 一 定 的 逻辑 顺序 逐 时 间 步 长 运行 。 





名 和 计 上 避 oo 和 而 | 0zs 十 | 洋 0 一 |j 





图 2.3.2 调试 工具 栏 


(2) 断 点 界面 。 调 试 器 提供 了 两 种 断 点 设置 方法 :一 是 普通 断 点 , 另 一 种 是 条 件 断 点 。 当 
模型 运行 到 用 户 设置 的 普通 断 点 时 ,会 无 条 件 停 止 ; 而 遇 到 条 件 断 点 时 , 则 会 判断 是 否 达 到 指 
定 的 条 件 ( 过 0, 除 0, 限 步 长 等 ), 是 则 停止 ,否则 继续 运行 。 用 户 可 以 在 断 点 界面 中 选择 断 点 
产生 的 条 件 。 条 件 断 点 设置 界面 如 图 2. 3. 3 所 示 。 

Zero crossing :模型 在 遇 到 过 零点 检测 时 产生 断 点 。 

@ Step size limited state: 在 状态 手动 条 件 约束 时 产生 断 点 。 

@) Solver error: 求 解 错 误 时 产生 断 点 。 

昌 NaN value: 仿 真 过 程 中 遇 到 无 限 大 ,或 溢出 时 产生 断 点 。 

@ Break at time: 指 定 产生 断 点 的 具体 时 刻 。 

在 断 点 产生 条 件 选 项 框 上 面 ,调试 器 提供 了 一 个 断 点 信息 显示 框 , 它 能 显示 当前 系统 中 已 
设置 断 点 的 模块 ,并 且 能 设置 是 否 显示 该 断 点 的 输入 /输出 。 通 过 Remove Selected Point 按 
钮 可 以 取消 相应 的 断 点 。 

断 点 是 非常 有 用 的 功能 。 特 别 是 当 用 户 知道 模型 中 的 某 处 可 能 存在 问题 时 ,通过 设置 适 
当 的 断 点 ,可 以 迅速 发 现 异 常 的 模块 和 数据 。 断 点 设置 的 方法 将 在 后 面 提 到 。 

(3) 仿真 循环 界面 。 仿 真 循环 界面 显示 "方法 ”的 三 列 相 关 信 息 :Method、Breakpoints、 
ID。 如 图 2. 3.4 所 示 。 


Break Points | Simulation Loop | 
K Points | 本 


Bre3ak Polints Slimulaton Loop 隐 
Niethod 了 ID 


BreakDisplay points | 2 -一 一 一 

一 一 下 | - ] 

| 贡 scks jj | = DDE_JWOTOR_FID Simulat | 口 ] 
一 一 二 -一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 





| | =|DC_WHOTOR_FTD Star 守门] 

Integrator 口 ] 
| Iantegzsteor.[ ] 
8 GPEconqSGRS 】 | Fromyorksp:[ ] 
三 Zero crosslng5s 


厂 Step sbze imited by stale Scope.Star-[ ] 
| 本 Cr 
Eastsrj 口 


| 

| | | 和 

| | 到 ootSYSt 训 访 Sta[ ] 
| 


DA N 一 臣 


rntrreirerrerryrereeeaeeterypererrereereeereeeeeaeayepeeaAreeyerweeerereereerotereewerreeeeeerrrrrrerrerreeerer 








人 图 2.3.3 断 点 设置 界面 图 2.3.4 仿真 循环 界面 
”和 滋 
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@ Method :方法 名 列 以 树 形 结构 列 出 了 从 仿真 开始 时 刻 至 此 的 所 有 "方法 "”。 树 形 图 的 
节点 表示 “方法 ?对 其 他 “方法 ”的 调用 ,展开 一 个 节点 即 可 观察 上 一 级 “方法 ”调用 的 次 级 “ 方 
法 ”。 单 击 包含 于 模块 中 的 “方法 ”( 蓝 色 ) 会 使 模型 中 相应 的 模块 高 亮 显示 。 

@ Breakpoints: 用 户 可 以 通过 断 点 列 的 复 选 框 设 置 断 点 。( 在 动画 模式 下 此 功能 无 效 。) 

四 ID :ID 列 按 顺 序 显示 方法 名 列 中 所 列 出 的 所 有 "方法 "的 ID 号 码 。 

(4) 信息 显示 界面 。 信 息 显 示 界 面 共 有 3 个 选项 卡 :Outputs .Sorted Lists 和 Status。 如 
图 2. 3. 5 所 示 。 





outputs ]}| Sorted List Status 
Warning: “Sigrnal storage reuse” is enabled for this model， Block I70 valu 办 | 
| In order to preserye block output Signal yalues，consider disabling the | 


Jarning- “Block reduction optimizatiorn is enabled for this model、Some nm 下 


| To be able to0 axeecute al] nor-virtual blocks consider disabLing the “Blo 


Warning: Usirneg a default yalue of 0.2 for maximun step size、 The Slim at 
广 之 一 全 到 人 一 人 aoc aa aa Lo na as na < aa an as me 丰 


[TI = 0 ] DC_WMOTOR_FID_Sinulate 
(sldebug B0): | 
一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 - | 
[到 =0 ] 0:0 Integrator.Start“DC_ NOTOR_FIDA7DC_moto 


(sldeabaug 83) : 
艺 





2.3.5 信息 显示 界面 


@O Outpnuts 选项 卡 :输出 调试 信息 和 结果 ,如 调试 命令 .调试 模块 状态 和 该 模块 的 输入 / 
输出 。 


@ Sorted Lists : 按 顺 序 显 示 调 试 过 程 中 的 非 虚 模块 。 


@ Status :显示 各 种 调试 设置 的 值 和 其 他 一 些 状态 信息 ,如 仿真 时 间 、 调 试 命令 和 调试 断 
点 等 。 


2.3.2 ”命令 行 调试 


通过 命令 行 模 式 调试 可 以 调用 调试 器 的 所 有 功能 ,这 对 高 级 用 户 来 说 非常 必要 , 也 很 
方便 。 


在 matlab 中 的 命令 窗口 中 输入 sim 命令 和 sldebug 命令 都 可 以 启动 调试 器 : 


>> sim(' 模 型 名 称 ',[0,10],simset(' debug' 必 on7)) 


或 者 

>> sldebug 模型 名 称 ' 

可 以 看 到 模块 已 经 被 打开 ,并 在 命令 窗口 中 显示 了 如 下 信息 ， 

% ----------------------------------------------------------==- 于 
[LTM = 0 ] 模型 名 称 .Simulate 


国 : 基于 模型 的 设计 一 一 MCU 篇 


此 时 调试 器 已 经 开始 运行 ,用 户 可 以 继续 输入 其 他 调试 指令 ,matlab 指令 或 者 输入 stop 


指令 停止 仿真 调试 。 更 多 的 调试 命令 可 通过 输入 help 命令 获取 。 


2.3.3 运行 调试 器 


在 GUI 模式 下 , 单 击 “ 开 始 / 继 续 ? 按 钮 首开 始 进行 调试 。Simulink 可 以 从 一 个 时 间 节 点 
执行 到 下 一 个 时 间 节 点 ;从 一 个 端点 执行 到 下 一 个 端点 ;或 从 一 个 模块 执行 到 另 一 个 模块 , 即 


单 步调 试 。 
1. 逐 模块 调试 


这 里 仍然 使 用 上 文 提 到 的 直流 电动 机 模型 。 打 开 模 型 ,在 matlab 工作 空间 中 定义 参数 ， 
单 击 工具 条 中 的 着 按钮 开始 调试 ,模型 上 方 会 出 现 一 个 调试 方法 指示 框 @DC_MOTOR_PID. 


Simulate, 提示 用 户 模型 已 进入 调试 状态 。 


单 击 工具 条 中 的 oo 按钮 执行 单 步 运行 ,会 看 到 有 一 个 箭头 由 指示 框 指向 模块 ,这 个 模块 
表示 下 一 步 即 将 执行 的 模块 。 以 后 每 执行 一 次 ,指示 框 和 箭头 都 会 产生 相应 的 变化 ,如 


图 2. 3. 6 所 示 。 








Signal Builder PID Controller 


DC_motor_ subsysterm 


图 2.3.6 模型 显示 调试 信息 
在 进行 单 步 调试 的 同时 ,仿真 循环 界面 中 会 以 高 亮 显示 下 一 步 即将 执行 的 模块 。 如 
图 2. 3.7 所 示 。 





针 芭 生疏 mr | 二 | 二 | 涪 5 cose | 
BreakPoints “Simulation Loop Outputs | Sorted List Status | 
| cliiiiiuaiiahliNESReievklniseobeoeac2ahhicNccaas 全， 站 
网 县 jn = 0.05 0;2 Integrater, Dotputs Winor“ 芒 _mukor_EIB7Suhs 
| jsldabsg 8125) 
下 se 
| | [rm =008 ] 0;3 Secepe Dutputz 了 nor “TDC _ motor FIIMSpeed 
| | |eaadeouc ail25) 
| 
| 1 ruee Data of 0:3 Seope boeck 克 _motor_EFIITSpeed 
| jm = [0.059999999999999609] We 
i 吕 上 一 步 仿真 方法 的 输出 
| -当前 时 间 :全 
天 re ITm = 0.05 二 ] 0:4 Sum Dutpauts. 用 inor “DC_nokor_PTUMSani 翁 
< 烷 -= -| jaasbsc ml27) 
和 的 各 ea ea 
下 一 步 执行 的 方法 
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如 果 采 用 Matlab 命令 行 方 式 调试 , 则 在 使 用 sldebug DC_MOTOR_PID 命令 后 输入 
step 命令 即 可 ,命令 窗口 输出 如 下 信息 ,TM=0 表示 当前 仿真 时 刻 为 0;sldebug @0 表示 即将 
被 执行 的 模块 为 当前 系统 的 第 一 个 模块 。 


车 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 己 二 一 一 一 全 有 二 一 一 一 一 有 一 一 一 一 之 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 第 
[ITM = 0 ] DC _MOTOR _PID. Simulate 

(sldebug @@0) : >> step 

第 一 一 一 一 一 一 王 和 一 一 定 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 第 
[TM = 0 ] DC _MOTOR_PID. Start 

《sldebug @1): >> step 

第 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 全 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 第 
[LTM = 0 ] RootSystem. Start "DC_MOTOR_PID” 

(sldebug 人 @@2) : >> step 

| 这 第 
[TM = 0 ] 0:0 Integrator. Start "DC_MOTOR _PID/DC_motor_subsystem/Integrator 


(sldebug @3) : >> step 
Data of 0:0 Integrator block 'DC_MOTOR_PID/DC_motor_subsystem/Integrator : 


CSTRATE = [0] 
% ------------------------------------------------------------- 和 
[TM = 0 ] 0:1 Integrator, Start "DC_MOTOR_PID/DC_motor_subsystem/ Integrator2” 


(sldebug @4) : >> 


2. 逐 时 间 步 长 单 步调 试 
逐 时 间 步 长 调试 是 按时 间 进 程 进行 的 ,相对 于 逐 模块 调试 ,其 调试 效率 较 高 ,这 对 于 复杂 
或 模块 数量 较 多 的 模型 相当 有 效 。 
在 GUI 方式 中 , 按 下 调试 器 上 的 绿色 开始 按钮 * ,启动 调试 ,在 未 设置 断 点 情况 下 ,每 按 
下 按钮 名 一 次 , 即 运行 一 次 仿真 步 长 ， 调试 输出 信息 如 图 2.: 全 8 所 示 。 














一 一 一 一 一 一 一 
本 Simulnk Debugeer pc- MOTOR pid LE | 
站 ec 0 一生 
于: 避 0 入 让 村 吕 江 : 全 家 0 ? 
| - 4 
| _BreakPoints | Simulation Loop L | outputs | sortedList | status | se 天 
ethod 性 芋 | | Warning: “BlLock reduction optimization” is enabled for this model， So 六 





| | 下 Pr | To be able t0 execute il] nonryirtual blocks consider diseabling the 
| | 让; 王 DC MOTOR pid Siaolata 于 





| 口 
| 
| 书 -DC_WDTOR_pid Start 吕 ] 
， me 
| DC_WOTOR_pid Initis 回 ] 半 一 -一 一 -一 一 一 
| |rmm = 0 ] DC_MOTOR_ pid Simulate 


| WarninEg: Using a default yalue of 0.2 for maximunm Step Size 、 The Sim 
| (sldebug @0) | 


二 











| | cm = ] BC_WOTOR_pid Start 

| | Glaebug 8l) 

| | 人 

| | [TU = 0 ] IC_NHOTOR pid Iaitialire InvariantConst | 

| | (sldebug 825) | 
上 | 





2.3.8 逐 时 间 步 长 单 步调 试 


本 基于 模型 的 设计 一 一 MCU 篇 


对 应 命令 行 方式 中 的 next 指令 ,利用 next 命令 可 以 执行 当前 时 间 步 长 中 的 所 有 模块 ( 通 
常 都 大 于 一 个 ), 直接 跳 到 下 一 个 仿真 时 间 步 长 。 


s ------------------------------------------------------------- < 
[LTM = 0 ] DC _MOTOR_PID. Simulate 

(sldebug @0) ;， >> next 

区 5 天 二 这 第 
LI = 0 ] DC_MOTOR_PID. Start 

(sldebug @@1) : >> next 

本 二 一 一 一 省 全 党 这 有 二 这 区 富 演 管 芝 芝 生 二 天 先 
[TM = 0 ] DC MOTOR_PID. Initialize, InvariantConstants 

(sldebug @25) , >> next 

” 渤 eaeeiecapeaadmsesahayeeeyeeatacnnsgeyeeany neetniehaimAesadcelheateree em 先 
LI = 0 ]」 DCc_MOTOR_PID. Enable. InvariantConstants 


(sldebug 人 @@27) : >> 


3. 自动 调试 
在 自动 调试 模式 下 ,系统 在 当前 仿真 步 长 内 ,自动 逐 方法 调试 ,每 个 方法 间 有 一 定 的 停顿 ，- 
同时 ,用 指针 指向 下 一 步 运行 的 方法 。 
按 下 工具 条 中 的 * 按 钮 开始 调试 , 单 击 按钮 #* 启 动 自 动 模式 ,通过 滚动 条 可 以 调整 停顿 时 
间 。 运 行 结果 如 图 2. 3. 9 所 示 。 


有 


多 
一 
~ 






Signal Builder PID Controller 


DC_motor_ subsystem 






图 2.3.9 自动 调试 


调试 指针 指向 的 模块 ,会 出 现 颜色 不 同 . 带 有 数字 的 小 方块 ,各 种 颜色 代表 了 不 同 的 方法 ， 
数字 表示 该 方法 被 调用 的 次 数 。 

注意 到 subsystem 和 PID Controller 模块 并 没有 出 现 带 颜色 的 方块 ,这 是 因为 系统 将 其 
判定 为 虚 模 块 ,而 模块 指针 只 做 用 于 非 虚 模块 。 打 开 subsystem, 可 以 看 到 其 中 的 非 虚 模块 已 
经 被 模块 指针 标注 了 调用 次 数 , 如 图 2. 3. 10 所 示 。PID Controller 的 情况 类 似 , 如 图 2. 3. 11 
所 示 。 可 通过 右 击 模块 ,在 弹出 的 右键 菜单 中 选择 Look Under Mask 命令 ,打开 其 底层 非 虚 


模块 。 
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图 2.3.10 电动 机 子 系统 的 调试 信息 





图 2.3.11 PID 系统 的 调试 信息 
运行 至 断 点 
当 确 知 模型 中 的 某 处 可 能 存在 问题 时 , 断 点 是 非常 有 用 的 ,通过 设置 适当 的 断 点 可 以 快速 


确定 异常 的 位 置 ,或 跳 过 异常 执行 后 续 仿 真 。 


在 积分 器 模块 处 设置 断 点 后 , 单 击 工具 条 中 的 按钮 , 输出 调试 信息 如 图 2. 3. 12 所 示 。 


不 Simulink Debugger DC DC_MOTOR_PID 0 
导 色 印 改 oa 站 村 | 本 | 于 当 05 
| outpuls | soredUList j Status 


| arning “Signal storace reuse is enabled for this aodel， Bock I/0 vealues 出 : 
Ia order to preserye block output 5 yalues，consider isabling the “Sig 


To be sble 《0 sxecete ALl nonrvirtuel blocks considar disabling the“BlLock re 





| 和 -一 -一 -一 一 -一 一 - -一 ---~-- 一 -一 -一 -一 - -~ 一 -----~-~~---- 一 ~- 和 
mw =o ] DC_M0TOR_PID_ Sinulate 
(sldsbog 90): 


arning'; “Block redaction 07timization is enabled For this aodel，Sone non-vii 1 
Tu =0 ] 0:0 Inategreater Start “IC_ HOTOR FTIADC noter_ robr | 








图 2.3.12 运行 至 断 点 


柄 := 基于 模型 的 设计 一 一 MCU 篇 


可 见 调试 进行 到 第 三 个 方法 时 遇 到 了 断 点 ,并 暂停 了 调试 。 在 命令 行 模式 中 ,可 以 用 
continue 命令 从 当前 断 点 运行 到 下 一 个 断 点 或 仿真 的 终点 。 断 点 设置 方法 将 在 后 面 提 到 。 


2.3.4 断 点 设置 


借助 断 点 可 以 快速 诊断 系统 ,找到 仿真 过 程 中 存在 的 错误 。Simulink 调试 器 允许 用 户 针 
对 不 同情 况 设 置 不 同类 型 的 断 点 :无 条 件 断 点 与 有 条 件 断 点 。 

《1) 无 条 件 断 点 :无 论 任 何 条 件 ,仿真 到 达到 预 设 断 点 处 即 中 断 运 行 。 

(2) 有 条 件 断 点 : 若 满足 断 点 条 件 ,仿真 到 达 预 设 断 点 处 即 中 断 运行 。 

1. 无 条 件 断 点 

无 条 件 断 点 可 通过 以 下 三 种 方法 设置 : 

@ GUI 调试 器 工具 栏 快捷 按钮 。 

@ GUI 调试 器 的 Simulation Loop 页 面 。 

@ 命令 窗口 。 

(1) 通过 GUI 调试 器 工具 栏 快捷 按钮 设置 断 点 。 在 模型 窗口 选中 需要 设置 断 点 模块 ( 例 
如 选择 Integrator 2) ,然后 单 击 图 形 调 试 器 工具 栏 中 的 Breakpoint 按钮 呈 设 置 断 点 。 断 点 页 
面 即 显示 当前 断 点 ,如 图 2. 3. 13 所 示 。 

用 户 可 以 在 模块 中 取消 勾 选 断 点 复 选 框 , 若 要 删除 模块 列表 中 的 断 点 ,可 以 单 击 Remove 
selected point 按钮 。 

(2) 通过 GUI 调试 器 的 Simulation Loop 选项 卡 设置 断 上 点。 此 设置 方法 需要 先 运行 调 试 
器 , 当 调 试 器 仿真 若干 个 模块 后 ,Simulation Loop 选项 卡 中 经 历 的 模块 才能 显示 出 来 ,对 于 复 
杂 系 统 , 需 要 执行 得 更 多 步 才能 显示 出 期 望 的 模块 ,如 图 2. 3. 14 所 示 。 


BreakPoints Simulation Loop | 


| ao lm 
SEE 
Eco 1 
Seootsystm ster 站 2 

一 Inategratar Stari 三 3 


seesste 到 






Break Points | Simulation Loop | 


BreakIDisplay points 










DC_motor_FTDATntegratar 了 


Remove Selected point 


图 2.3.13 断 点 设置 图 2.3.14 运行 至 断 点 


(3) 通过 命令 窗口 设置 断 点 。 命 令 窗 口 设 置 断 点 的 方法 只 适用 于 命令 行 调试 模式 下 ,在 
该 模式 下 ,命令 break 和 bafter 分 别 用 来 在 模块 的 前 端 和 后 端 设 置 断 点 ,clear 命令 则 用 来 清 
除 断 点 ,命令 行 调试 窗口 的 输出 信息 如 下 : 


[ITM = 0 ] DC _MOTOR_PID. Simulate 
(sldebug @0): >> step 
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[TYM = 0 ] DC_MOTOR_PID. Start 
(sldebug @@1) :， >> break 
Installed break point:0 before m:1 


(sldebug @@1) : >> bafter 
Installed break point:1 after ;1 


《sldebug 四 1) : >> clear 
Break point ' 0 "has been removed. 
Break point "1 "has been removed. 


(sldebug 人 91) : 5 


2。 条 件 断 点 Breakon conditions 
四] zero crossings 


无 条 件 断 点 的 特点 是 每 当 系 统 运 行 到 无 条 件 断 点 口 ] Siep size limited by state 
处 时 都 会 暂停 。 而 条 件 断 点 处 是 否 发 生 中 断 还 不 确定 , 取 口 sover Eror 


决 于 具体 的 运行 情况 是 否 符合 条 件 , 如 图 2. 3. 15 所 示 。 Saaba 
在 断 点 设置 界面 中 的 下 部 复 选 框 中 可 以 选择 中 断 
其 对 应 的 命令 行 指令 如 下 : 


@ zcbreak :仿真 发 生 过 零 时 设置 断 点 。 

@ xbreak :仿真 步 长 超过 模型 步 长 限制 时 设置 断 点 。 

@ ebreak :求解 出 错 处 设置 断 点 。 

@ nanbreak :数值 溢出 或 无 穷 大 时 设置 断 点 。 

(1) Zcbreak。 当 需要 对 模型 的 过 零 情 况 进 行 中 断 时 , 勾 选 Break on conditions 中 的 Zero 
crossings 复 选 框 或 在 命令 窗口 中 执行 zcbreak 命令 。 暂 停 后 显示 该 中 断 在 模型 中 的 ID 类 
型 .名 称 、. 时 间 , 以 及 在 过 零 时 是 上 升 还 是 下 降 。 

在 命令 行 调 试 模式 下 ,使 用 zcbreak 命令 设置 过 零 断 点 ,continue 命令 开始 运行 仿真 ,在 
下 一 断 点 或 当前 仿真 步 长 末尾 前 停止 运行 ,过 零 中 断 的 输出 信息 如 下 : 


$ ------------------------------------------------------------- 
[rm = 0 ] DC_MOTOR_pid, Simulate 
(sldebug @@0) : 


1 Zero crossling detected at the following location 
0 0:3:0 FromWorkspace "DC_MOTOR_ pid/Signal Builder/FromWs 
ZeroCrossing Events detected.， Interrupting model execution 


(2) Xbreak。 该 命令 主要 是 针对 变 步 长 求解 器 , 勾 选 Break on conditions 中 的 Step size limit- 
ed by state 复 选 框 ,或 在 命令 窗口 中 使 用 Xbreak 命令 。 当 求解 器 所 采用 的 步 长 超过 模型 的 步 长 
限制 时 ,仿真 就 会 自动 中 断 , 这 种 中 断 方 式 主要 用 于 调试 那些 有 可 能 需要 过 大 仿真 步 长 的 模型 。 


as 


本 -: 基于 模型 的 设计 一 一 MCU 篇 


[TM = 0 ]Dc_MOTOR_PID. Output. InvariantConstantSs 
(sldebug 人 @30) : >> xbreak 
Break on failed integration step :; enabled 


(sldebug @@30) : >> 


(3) Ebreak 。 勾 选 Break on conditions 中 的 Solver Error 复 选 框 ,或 在 命令 窗口 中 输入 
ebreak 命令 ,系统 将 在 检测 到 一 个 可 恢复 的 错误 时 产生 中 断 。 如 果 用 户 未 设置 此 条 件 断 点 ， 
系统 将 会 自动 修复 错误 ,但 是 不 会 发 出 提示 信息 。 


[zM = 0 ] DC_ MOTOR PID. Output. InvariantConstants 
(sldebug 人 @@30) : >> ebreak 


Break on SoLVver error ;， enabled 


(sldebug 人 @30) : >> 


(4) NaNbreak。 勾 选 Break on conditions 中 的 NaN values 复 选 框 ,或 在 命令 行 调 试 模 式 
输 和 人 nanbreak 命令 ,系统 将 在 求解 器 计算 出 一 个 无 穷 大 数值 或 滋 出 时 产生 中 断 。 设 置 这 类 中 
上 灯 , 可 以 精确 地 找到 系统 中 的 计算 错误 。 


币 - 前- 让 .本 区 -而 各 -和 人 全 


% ------------------------------------------------------------- 和 
LTM = 0 ] DCc_MOTOR_PID. Output. InvariantConstants 

(sldebug 包 30) : >> nanbreak 

Break on non -~ finite (NaN,Inf) values : enabled 


(sldebug @30) : >> 


(5) Tbreak 。 在 Break on conditions 的 Break at time 文本 框 输入 时 间 ,或 使 用 tbreak 命 
令 设 置 时 间断 点 ,系统 会 将 在 指定 的 时 刻 的 下 一 个 步 长 处 中 断 并 停留 在 模型 的 Outputs. Ma- 
jor 方法 。 


2.3.5 显示 模型 和 仿真 信息 


1. 显示 模块 的 输入 /输出 信息 
通过 调试 器 工具 栏 上 的 按钮 as 和 按钮 于 显示 模块 的 输入 /输出 。 用 于 命令 行 模式 的 相应 
指令 由 probe disp ,trace。 调 试 命令 trace gcb 与 probe gcb 分 别 对 应 于 上 述 两 个 按钮 ,但 
probe 和 disp 命令 并 没有 与 之 相对 应 ,下 面 解释 其 不 同 之 处 。 
(1) 设置 模块 的 输入 /输出 显示 点 。 在 GUI 界面 下 ,选中 模型 中 某 一 模块 后 , 单 击 按钮 
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nm, 断 点 /显示 点 列表 将 列 出 当前 设置 的 显示 点 。 在 命令 行 模式 下 ,该 按钮 对 应 的 命令 是 trace 
gcb 或 trace s:b。 前 者 为 当前 模块 设置 显示 点 ,后 者 可 直接 针对 某 个 模块 进行 设置 ,其 中 s 表 
示 系 统 顺 序 ,b 表示 模块 顺序 。 例 如 ,在 模型 中 选中 sum 模块 ,然后 再 命令 行 模式 下 调试 ,使 用 
next 命令 执行 到 TM=3 之 后 ( 即 阶 牙 信 号 开始 跳 变 ) ,执行 probe 命令 , 则 可 显示 此 时 的 sum 
模块 输入 /输出 。 


本 生硬) 已 - 醒 ] 二 


[TM = 3.020454598515591 」 DC _MOTOR _PID. Outputs. Major 
(sldebug @@41) : >> probe 

Entering block probe mode. Click on any block to see its data， 
TYpe any command to leave Probe mode. 

Probe: Data of 0:5 Sum block 'DC_ MOTOR PID/Sum '; 


U1 = [0.98177007864064314] 
U2 = [0.018229921359356905 ] 
Y1 = [0.98177007864064314] 


和 





若 要 观察 同一 时 刻 其 他 模块 的 输入 /输出 ,可 在 模型 中 选中 相应 的 模块 ,命令 行 中 会 立即 


显示 其 当前 输入 /输出 。 例 如 选中 PID 模块 ,命令 行 输出 以 下 信息 : 


下 面 二- 性 亿 豆 本 


[ITN = 3.020454598515591 ]DC_MOTOR_PID. Outputs. Major 
(sldebug @41) : >> probe 

Entering block probe mode， Click on any block to see jits data， 
TYpe any command to 1]eave probe mode. 

Probe: Data of 0;5 Sum block 'DC _ MOTOR _PID/Sunm'， 


U1 = [0.98177007864064314 ] 

U2 = [0.018229921359356905 ] 

Y1 = [0.98177007864064314 ] 

Probe， Data of SubSystem block (virtual) ' DC_MOTOR_PID/PID Controller ': 
U1 = [0.98177007864064314] 

Y1 = [8.6319002707974715] 


re 


(2) 显示 选中 模块 的 输入 /输出 。 在 GUI 界面 下 ,选中 模型 中 某 一 模块 后 , 单 击 按钮 闻 会 


选中 sum 模块 并 单 击 按钮 王后 可 得 到 图 2. 3. 16 所 示 的 输出 结果 。 


在 Outpnut 界面 中 显示 当前 状态 下 选中 模块 的 其 IVO 信息 ,在 命令 行 模式 下 ,probe s:b 命令 与 
之 对 应 。 


在 命令 行 模式 下 ,选中 分 别 选中 PID 模块 和 sum 模块 并 执行 probe gcb 指令 ,命令 窗口 


中 结果 如 下 : 


505 


二 - 基于 模型 的 设计 一 一 MCU 篇 


| Dutputs 


豆 = 
玫 旺 
四 


上 YL 


LsoredUist j staus | 
[0. 9886793523T258719] 人 
[0. 011320647627412844] 
[0. 98867935237258719] 


| Trace: Data of 0:5 Sum block “DC_WOTDR_ FIT7Sum : 


| JU = 
U2 = 
;全 1 一 


[0.98488189147248295] 
[0.015118108527517099] 
[0.984688189147246295] 


| rrace: Data of 0:5 Sumn block “DC_WDTOR_PITDySunm' : 


lm = 
| 到 村 


证 


| 1 = 


[0. 98177007864054314] 
[0.018229921359356905] 
[0. 98177007864064314] 


图 2.3. 16 outputs 界面 


[TM = 3.020454598515591 ] DCc_MOTOR_PID. Outputs. Major 
(sldebug 四 41) : >> probe gcb 


Probe: Data of SubSystem 


block (virtual) "DC_MOTOR _PID/VPID Controller "， 


U1 = [0.98177007864064314 ] 
Y1 = [8.6319002707974715 ] 


(sldebug @41) : >> probe gcb 
probe: Data of 0:5 Sum block "DC_MOTOR_PID/Sum ': 


U1 = [0.98177007864064314] 
U2 = [0.018229921359356905 ] 
Y1 = [0.98177007864064314 1] 


(sldebug @41) : >> 


使 用 probe 指令 可 以 使 调试 器 进入 probe 状态 ,这 时 用 户 选中 模型 的 任意 一 个 非 虚 模 块 时 , 命 
令 窗 口中 就 会 显示 其 IO 信息 ,这 比 上 面 的 方法 更 加 简单 。 再 次 输入 probe 指令 可 退出 该 模式 。 

(3) 显示 断 点 处 的 模块 输入 /输出 信息 。 在 命令 行 模式 下 ,调试 命令 disp gcb / disp s:b 
用 于 设置 当前 或 指定 的 模块 在 调试 中 断 时 显示 其 输入 /输出 ,命令 undisp gcb / undisp s:b 可 
移 去 当前 或 指定 的 显示 点 (其 中 s 表示 系统 顺序 ,b 表示 模块 顺序 ) 。 

该 指令 只 能 在 命令 行 模式 下 运行 ,在 GUI 界面 中 无 法 实现 。 

在 设置 中 断 点 后 ,每 单 步调 试 一 个 模块 ,命令 行 窗 口 都 会 显示 一 次 该 模块 的 输入 /输出 。 
例如 ,输入 指令 disp 0:0, 将 会 显示 模块 : 


DC_MOTOR_PID/DC_motor_subsystem/Integrator 的 输入 /输出 信息 


要 人 生生 本 4 全 1 汪 "本 全 二 生生 
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[mM = 3.020454598515591  ，] DC_MOTOR_PID. Outputs, Major 
(sldebug @41): >> disp 0:0 

Installed data display of 0:0 Integrator block" 
DC_MOTOR_PID/DC _motor_subsystem/ Integrator 


(sldebug 人 @@41) : >> next 


Disp， Data of 0:0 Integrator block 
DC_MOTOR_PID/VDC_motor_subsystemy/ Integrator '; 


U1 = [17.263800541594943 ] 
Y1 = [0.033780793929875291 ] 
CSTRATE ”= [0.37426778201746674 ] 


[TM = 3.020454598515591 ] DC _MOTOR_PID. Update 
(sldebug 人 @@@965) : >> 


注意 ,0:0 为 DC_ MOTOR _PID/DC _motor_subsystem/Integrator 模块 的 ID 序号 ,每 个 
模块 的 ID 序号 都 可 以 在 Sorted List 子 界 面 中 找到 ,下 面 将 具体 介绍 该 界面 。 


2. 显示 模型 信息 


(1) 显示 模块 执行 顺序 。GUI 界面 的 Sorted List 选项 卡 显 示 了 模型 中 的 每 个 模块 和 非 
虚 子 系统 。 该 界面 列 出 了 各 模块 的 执行 顺序 及 模块 ID 号 ,如 图 2. 3. 17 所 示 。 


Dutputs Sorted List | Status 


-~-- Sorted list for "IC NIDTOR FID [22 nonyirtual blocks，direct 了 eed-0] 
0: DC_WOTOK_PID/7DC_motor_subsystemn/Tniegrator Cntegrator) 

PC WOTOR FITD/ADC_mator_subsystem/Irnegrator2 Untegrator) 
IC_WMOTGR_FIDADC motor_sdbsystemrTrteEratorl Untegrator) 
DC WOTDR FTID/Sizgnal Builder Fromgs” (romWorkspace) 

DC _WOTGRE_ FTDASceops Gecope) 

DC_WOTOR_FIJ7Sun ” Guan) 

“DC _WDTOR FTDVFIJ ControllerFroporrcional Gaimr (Gain) 
DC_MITOR FTDAFPITD Controller/TIntegrator ” (Integrator) 
IC_WMOTDE FID/APID Controller7Derivarivye Gaim (Gain) 

“IC WOTORE FIDAFID CortrolleryFilter” (Cntegrator) 
DC_JDOTOR_FITDAEITD Controlleary Sum” Goum) 

IC _WDTORK PITD7FID ControlleryFilter Cosfficiant (Gain) 

DC _WOTOR_PTJ7PID CorntrellerySom (Sun) 
DC _MDTOR_PID/ADC_motoyr subsystemfGazn5” (Cain) 


IC_MOTDR_FTBAIC_mnotor_subsysten/Gainl” (Gain) Y 


四 


DoSoooooDooooooDooo 
9 Le jp ee - 尽 避 F: 0 
六 一口 


一 
5 


图 2.3.17 Sorted List 选项 卡 
在 命令 行 模 式 下 可 以 用 slist 命令 来 显示 模型 的 列表 顺序 : 


(sldebug @0): >> sldebug 'DC_motor_PID" 


、 89 。 : 


国 : 基于 模型 的 设计 一 一 MCU 篇 


《sldebug 四 0) : >> slist 
(sldebug 人 0): >> slist 


一 一 Sorted list for "DC_MOTOR_PID' [22 nonvirtual blocks，directFeed = 0] 


0;:0 


局 号 
nn hm ti 情 


0 ;21 


(2) 显示 调试 器 状态 。 在 GUI 界面 下 ,Status 选项 卡 中 列 出 了 调试 器 各 种 选项 的 设置 情 


"DC_MOTOR_PID/DC_ motor _subsystem/ Integrator " (Integrator) 
"DC_MOTOR_PIDVDC_motor_subsystem/ Integrator2 ' (Integrator) 
"DC_MOTOR_PID/VDC motor_subsystem/ Integratorli " (Integrator) 
"DC_MOTOR_PID/VSignal Builder/FromWs " (FromWorkspace) 


"DC_MOTOR_PID/Scope ' (Scope) 
"DC_MOTOR_PID/Sum' (Sum) 


“DC_MOTOR_PID/VPID Controller/Proportional Gain' (Gain) 


“DC_MOTOR_PID/VPID Controller/Integrator " (Inteqrator) 
"DC_MOTOR_PID/BPID Controller/Derivative Gain' (Gain) 
“DC_MOTOR_PID/VPID Controller/Eilter" (Integrator) 
"DC_MOTOR_PID/VPID Controller/SumD ' (Sunmy) 
"DC_MOTOR_PID/PID Controller/Filter Coefficient ' (Gain) 


'DC_MOTOR_PID/PID Controller/Sum' (Sum) 


"DC_MOTOR_PID/ADC_motor_subsystem/Gain5 " (Gainy) 
"DC_MOTOR_PID/DC_motor_subsystem/Gainl" (Gain) 
"DC_MOTOR_PTDVDC_motor_subsystem/ahdd' (Sum) 
"DC_MOTOR_PID/DC_motor_subsystem/Gain2" (Gain) 
"DC_MOTOR_PID/DC _motor_subsystem/Gain4 (Gain) 
"DC_MOTOR_PID/DC_motor_subsystem/aRddl " (Sum) 
"DC_MOTOR_PID/DC _motor_subsystem/Gain " (Gain) 
“DC_MOTOR_PID/DC_motor_subsystem/Gain3 (Gain) 
"DC_MOTOR_PID/PID Controller/Integral Gain' (Gain) 


襄 , 例 如 条 件 断 点 ,如 图 2.3. 18 所 示 。 


:全 20 


| outputs | Sonedtist | Stauus | 
Current simulation time 

| Solver meeds reset 

| 5clver derivatives cache needs reset 


了 ero Crossing siegrals cache meeds ioset 


| Default conmand to execute 0n rwhtrnantar : 


| Break at xero crossing events 

| Break on soLYer error 

| 5reak on failed inteEreation Stem 

| 了 ime breek point 

| Break om nonrfinite (WiaNTnf) values 
| reajk om 50]LYer 于 作 生 丰 人 开赴 可 0 看 节 

| Display level for disp，trace，probe 
| Solver trace evo 

| 头 L gebraic 1oop tracing Level 
Amimation Mode 


1 于 indow rese 


disabled 


disabled 
: dissbled 
: 由 sabled 
) 二 Sbled 
中 sabled 


1 避 /oo，states] 
0 


ofE 


” mot Supported 


2.3.18 Status 选项 卡 


: 0.0 人 slJsrTimestey) 


-了 0 
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在 命令 行 模式 下 ,可 以 使 用 status 指令 来 显示 调试 器 的 设置 情况 : 


] DC _MOTOR_PID. Simulate 
(sldebug @ 四 0) : >> status 


Current simulation time 

Solver needs reset 

Solver derivatives cache needs reset 
Zero crossing signals cache needs reset 
Default command to execute on return/enter : ” 
Break at zero Crossing eventS 

Break on solver error 

Break on faliled integration step 

Time break point 

Break on non -finite (NaN,Inf) values 
Break on Solver reSet request 

Display level for disp，trace，Pprobe 
SolVvezr trace Level 

有 Lgebraic 1oop tracing Level 

Animation Mode 

Window reuse 

Execution Mode 

Display level for etrace 

Break polints 

Display points 

Trace points 


: 0.0 (MajorTimeStep) 


+ DO 


DO 


PnO 


disabled 


: disabled 


disabled 


; disabled 
: disabled 


9 


disabled 


; 1〈i/o，states) 
二 和 

: 1 

; Of 人 人 


not Supported 
Normal 
0 (disabled) 


;， none installed 
: none installed 
: none installed 


(3) 显示 潜在 过 零点 模块 。 在 仿真 过 程 中 zcjist 指令 能 够 列 出 模型 中 所 有 可 能 会 产生 非 


采样 过 零点 的 模块 : 


] DCc_MOTOR_PID. Simulate 
(sldebug @0) : >> zclist 
0 0:3:;0 


R FromWorkspace "DC_MOTOR_PID/Signal Builder/FEromWs” 


了 全 和 2 


第 3 章 
Stateflow 建 模 与 尿 用 





Stateflow 是 有 限 状 态 机 (人 (finite state machine) 的 图 形 工 具 , 它 通过 开发 有 限 状 态 机 和 流 
程 图 扩展 了 Simulink 的 功能 。Stateflow 使 用 自然 .可 读 和 易 理 解 的 形式 ,使 复杂 的 逻辑 问题 
变 得 清晰 与 简单 ,并 且 与 MATLAB/Simulink 紧密 结合 ,为 包含 控制 .优先 级 管理 .工作 模式 
逻辑 的 典 人 式 系 统 设 计 提 供 了 有 效 的 开发 手段 ,是 本 书 的 核心 内 容 之 一 。 读 者 在 第 5 一 8 章 将 
看 到 Stateflow 应 用 于 MCU 器 件 的 嵌入 式 开 发 ,一 些 采 用 传统 方法 难以 实现 的 算法 ,利用 
Stateflow 建 模 将 显得 非常 容易 。 利 用 Stateflow Coder 代码 生成 工具 ,可 以 将 Stateflow 状态 
图 模型 直接 生成 C 代码 。 

Stateflow 的 主要 功能 包括 以 下 几 方 面 : 

(1) 使 用 层次 化 .可 并 行 的 有 明确 执行 语义 的 元 素 , 来 描述 复杂 的 逻辑 系统 。 

(2) 采用 流程 图 定义 图 形 化 晒 数 。 

《3) 利用 真 值 表 实 现 表格 形式 的 功能 。 

(4) 使 用 临时 逻辑 处 理 状态 转移 与 事件 。 

(5) 支持 Mealy 和 Moore 有 限 状态 机 。 

(6) 可 集成 用 户 自 定义 的 C 代码 。 

《7) 可 用 动画 的 形式 显示 状态 图 的 仿真 运行 过 程 ,并 可 记录 数据 。 

《8) 调试 器 使 用 图 形 化 断 点 进行 单 步调 试 ,并 可 观察 其 中 的 数据 。 

本 章 主 要 内 容 ， 

(1) Stateflow 工作 原理 与 基本 概念 。 

(2) 建立 Stateflow 状态 图 与 流程 图 。 

(3) Stateflow 的 层次 结构 与 并 行 机 制 。 

(4) Stateflow 应 用 。 


3.1 Stateflow 基本 概念 


Stateflow 对 象 可 分 为 图 形 对 象 与 非 图 形 对 象 。 
图 形 对 象 有 状态 .历史 节点 .迁移 .默认 迁移 .连接 节点 、 真 值 表 .图 形 数 .Embedded 
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MATLAB 函数 . 盒 本 数 .Simulink 函数 ; 非 图 形 对 象 有 事件 数据. 目标。 本 节 首 先 介绍 常用 
的 对 象 :状态 .迁移 .数据 .事件 的 概念 和 使 用 。 

Stateflow 状态 机 使 用 一 种 基于 容器 的 层次 结构 管理 Stateflow 对 象 ,也 就 是 说 ,一 个 
Stateflow 对 象 可 以 包含 其 他 Stateflow 对 象 。 

最 高 级 的 对 象 是 Stateflow 状态 机 , 它 包 含 了 所 有 的 Stateflow 对 象 , 因 此 也 就 包含 了 
Simulink 中 的 所 有 Stateflow 状态 图 ,以 及 数据 .事件 .目标 对 象 。 

同样 地 ,状态 图 包含 了 状态 、 盒 函数 .本 数 .数据 .事件 .迁移 .节点 与 注释 事件 (note e- 
vents) 。 用 户 可 以 使 用 这 一 系列 对 象 ,建立 一 个 Stateflow 状态 图 。 而 具体 到 一 个 状态 , 它 也 
可 以 包含 上 述 的 对 象 。 

图 3. 1. 1 抽象 地 说 明了 这 样 的 关系 ,而 图 3. 1. 2 则 具体 地 说 明了 Stateflow 状态 机 的 组 成 。 
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图 3.1.1 Stateflow 层次 结构 (数据 字典 ) 


D 中 回 纯 记 :中 当 一 ev fn 


上 Eee 状态 机 
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图 3.1.2 Stateflow 状态 机 的 组 成 
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3.1.1 状态 图 编辑 器 


在 Simulink 模块 库 浏览 器 中 ,找到 Stateflow 模块 ,如 图 3. 1. 3 所 示 。 添 加 入 模型 窗口 ， 
如 图 3.1.4 所 示 。 

用 户 也 可 以 使 用 以 下 命令 ,建立 带 有 Stateflow 状态 图 的 Simulink 模型 ,如 图 3.1.4 所 
示 。 同 时 打开 Stateflow 模块 库 ,如 图 3.1.5 所 示 。 


>> sf 


| 副 Smuinx Design verifer 
+- 藤 | Smuimk Extras 

国 Suxvwikcsioendveiasiom | 
| 勤 System dentification fobox 

+- 吕 iarcet Support Package 

+- 吕 Rarget for MicrochipCTM) dsPIC Chat 

+- 贡 Vehicle Network folbox 

+- 重 | Video and Image Processing 6lockset 和 = | 


3.1.3 Stateflow 模块 


| Ele Ed Yiew Smulation Format Ioosg Hep | 


[Di 世上 加 与 语 | 人 Pj 之 开 | 


{Double click to open the 








1 人 Chart Tuth Table 。 Statefow Examples Library) 
图 3.1.4 带 有 Stateflow 状态 图 的 Simulink 模型 3.1.5 Stateflow 模块 库 
用 户 还 可 以 直接 使 用 以 下 命令 ,快速 建立 带 有 Stateflow 状态 图 的 Simulink 模型 。 
>> sfnew 
双击 Chart 模块 ,打开 Stateflow 编辑 器 窗口 ,如 图 3. 1.6 所 示 , 左 侧 工具 栏 列 出 了 State- 
flow 图 形 对 象 的 按钮 。 
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图 3.1.6 Stateflovw 编辑 器 窗口 
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3.1.2 状 态 


状态 可 以 理解 为 事件 驱动 系统 中 的 模式 ,可 分 为 激活 与 非 激活 状态 ,而 状态 是 否 激活 则 是 
由 状态 图 中 的 事件 与 条 件 来 决定 的 , 若 没 有 预先 定义 的 事件 或 条 件 发 生 , 状 态 将 一 直 保持 其 原 
先 的 激活 或 非 激 活 状态 。 


1. 状态 的 层次 结构 


状态 可 以 包含 除了 目标 ( 详 见 第 3. 6. 6 节 ) 以 外 的 所 有 Stateflow 对 象 ,所 以 状态 内 部 可 以 
有 其 他 状态 ,如 图 3. 1.7 所 示 , 处 于 外 层 的 A 称 作 超 状态 (或 


父 状 态 ), 处 于 内 部 的 B 称 作 子 状态 。 
每 一 个 状态 都 有 其 父 状 态 ,在 图 3. 1. 7 中 ,状态 A 的 父 


状态 就 是 Stateflow 状态 图 本 身 。 
2. 状态 的 横向 结构 


图 3.1.7 超 状态 与 子 状态 在 Stateflow 状态 图 的 顶层 或 某 一 超 状态 下 ,通常 并 存 
有 多 个 状态 ,它们 之 间 的 关系 可 分 为 互 斥 与 并 行 。 

(1) 互 斥 状态 (COR) 。 互 斥 状 态 的 矩形 框 边缘 显示 为 实 线 , 同 一 级 的 互 斥 状态 ,至 多 人 允许 
激活 一 个 状态 。 互 斥 状 态 如 图 3. 1.8 所 示 ,状态 A 与 状态 B 是 互 斥 的 ,它们 只 能 有 一 个 处 于 
激活 状态 ; 当 状 态 A 被 激活 时 ,同样 其 子 状 态 Al 与 A2 也 只 能 有 一 个 处 于 激活 状态 。 

《2) 并 行 状态 (AND)。 并 行 状 态 的 抢 形 框 边缘 显示 为 虚线 ,同一 级 的 并 行 状态 ,可 在 同 
一 时 刻 被 激活 。 并 行 状态 如 图 3. 1. 9 所 示 。 状 态 A 与 状态 B 是 并 行 的 ,它们 可 同时 处 于 激活 
状态 ; 子 状态 Al 与 A2 也 同时 处 于 激活 状态 ,而 子 状态 Bl 与 B2 只 能 有 一 个 处 于 激活 状态 。 


天 


人 RE 有 
; : A ， 7 日 
| A1 1 ， 
AA1 可 
| ， 和 
| :| 
国清 人 
上 
Ce 网 
一 一 一 一 人 
图 3.1.8 互 斥 状 态 图 3.1.9 并 行 状 态 


状态 层次 结构 与 并 行 机 制 的 详细 概念 与 应 用 , 见 3.4 节 与 3.5 节 。 
3. 状态 标签 


状态 名 仅 是 状态 标签 的 一 部 分 ,完整 的 标签 格式 如 下 ,第 一 行 是 状态 名 ,以 下 若干 行 是 各 
类 动作 ,用 户 可 以 设置 全 部 或 部 分 的 状态 动作 , 当然 也 可 以 不 设置 任何 动作 。 
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namey/ 外 状态 名 

entry: entry actions 先进 人 该 状态 时 的 动作 

during， during actions $ 处 于 该 状态 时 的 动作 

exit， exit actions % 退 出 该 状态 时 的 动作 

on event_name: on event_name actions 负 某 事件 发 生 时 的 动作 

bind: events ，data $% 指定 需要 限制 作用 范围 的 事件 与 数据 


(1) 状态 和 名。 状态 名 可 由 字母 .数字 .下 画 线 组 成 ,如 果 状 态 名 后 跟随 的 是 回 车 符 , 则 斜 线 
是 可 有 可 无 的 。 根 据 Stateflow 的 分 层 结构 , 同 级 的 各 个 子 状 态 不 允许 重 名 ,但 不 同 级 的 状态 - 
则 不 受 限制 。 

图 3. 1. 10 所 示 的 Stateflow 状态 图 是 有 效 的 ,尽管 看 上 
去 状态 On .Off 有 重 名 现象 ,但 在 Stateflow 分 层 结构 中 ,它们 
的 全 名 分 别 如 下 ， 国人 几 呈 


及, Of 下 


B. On 
B. Off 图 3.1.10 状态 名 
(2) 状态 动作 。 状 态 动作 如 表 3. 1. 1 所 列 。 


表 3.1.1 状态 动作 类 型 

动作 类 型 

entry 进入 当前 状态 时 的 动作 

during 处 于 当前 状态 ,并 且 某 事件 发 生 时 的 动作 
离开 当前 状态 时 的 动作 


eXit 


约束 一 个 事件 或 数据 ,使 得 仅 当 前 状态 及 其 子 状 态 有 权限 广播 该 事件 或 
修改 该 数据 


当前 状态 接收 1 次 广播 事件 时 的 动作 


bind 


on event_name 


当前 状态 完整 接收 ”次 广播 事件 后 的 动作 


on after(nyevent_name) 


当前 状态 完整 接收 次 广播 事件 前 的 动作 


on before(n,event_name) 


当前 状态 完整 接收 次 广播 事件 时 的 动作 


on at(tn，event_narme) 


当前 状态 每 接收 次 广播 事件 时 的 动作 


on every(nyevent_name) 


蜗 


每 个 动作 类 型 ,用 户 可 指定 多 个 具体 动作 ,每 个 动作 之 间 以 回 车 ,分 号 .逗号 区 隔 ,动作 类 
型 关键 词 后 必须 跟随 一 个 半角 冒号 。 

@ entry 动作 。 关 键 词 为 entry( 或 缩写 为 en) 。 如 果 用 户 在 状态 名 后 加 入 斜 线 ,并 直接 跟 
随 具体 动作 , 则 该 动作 默认 为 进入 动作 。 如 图 3. 1. 11 所 示 ,进入 状态 A 时 ,y=3, 同 时 又 执行 
y 十 十 ,最 终 的 结果 为 > 一 4。 

@ during 动作 。 关 键 词 为 during( 或 缩写 为 du) 。 如 图 3. 1. 12 所 示 , 进 人 状态 A 时 ,y 王 
3, 同 时 不 断 执 行 y 十 十 。 若 求解 器 的 定点 步 长 取 0. 2 ,仿真 时 长 取 2, 则 最 终 的 结果 为 y= 王 13。 
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图 3.1.11 entry 动作 3.1.12 during 动作 


@ exit 动作 。 关 键 词 为 exit( 或 缩写 为 ex) 。 如 图 3. 1. 13 所 示 ,系统 处 于 状态 A, 当 A 的 
激活 时 间 达 到 5 个 仿真 步 长 ,退出 状态 A, 进 入 状态 B, 最 终 的 结果 为 y= 王 4, 如 图 3.1.14 所 示 。 


2 
1 





图 3.1.13 exit 动作 图 3.1.14 输出 结果 


盐 广播 事件 动作 。 表 3. 1. 1 所 列 的 广播 事件 动作 ,能 实现 各 种 事件 触发 。 

以 单 次 广播 事件 动作 为 例 ,关键 词 为 on event_name, 其 中 event_name 表示 某 一 广播 事件 
名 ,事件 名 应 是 唯一 的 。 如 图 3. 1. 15 所 示 , 系 统 处 于 状态 A, 当 检测 到 事件 stop, 立 即 执 
行 c() 。 





图 3.1.15 广播 事件 动作 
@ bind 动作 。 关 键 词 为 bbnd。 如 图 3. 1. 16 所 示 ,变量 y、. 事 件 start 被 绑 定 在 状态 A, 这 
表示 仅 有 A 状态 及 其 子 状 态 有 权限 修改 变量 y 并 广播 事件 start, 其 他 状态 B 能 够 读 取 变量 
y\ 监 听 到 事件 start, 但 无 权 修改 变量 > 广播 事件 start。 





图 3.1.16 bind 动作 
若 运行 该 状态 图 ,系统 提示 变量 y 仅 能 由 状态 A 及 其 内 部 的 状态 迁移 修改 ,事件 start 仅 


GIF 各 
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能 在 状态 A 及 其 内 部 迁移 进行 广播 ,如 图 3. 1. 17 所 示 。 
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图 3.1.17 错误 提示 


与 其 他 动作 不 同 ,bind 动作 不 需要 判断 当前 状态 是 否 已 激活 ,也 就 是 说 它 在 整个 State- 
flow 状态 图 范围 内 都 是 有 效 的 ,因此 不 同 状态 不 允许 约束 同一 个 变量 与 事件 。 
如 图 3. 1. 18 所 示 ,状态 A.B 同时 约束 了 变量 y, 系 统 提 示 这 是 不 允许 的 ,如 图 3. 1. 19 


所 示 。 





图 3.1.18 无 效 的 bind 动作 


INW Econt Size 


Message SOUrCe Reported 8y Summary 
国 Parse Error 攻 Stateflow _Muitiple 5 State5 乒 人 19) and dB 伟 20] 3 ae both bound to 多 伟 23)、 Thisi 上 
全 Parse Error 计 Parse 


铂 Model er.， Unknown Simulink Muttiple state5 上 卢 19) and 8B 伴 20) are both boundtoy 伟 23]. This i ,. 


克 slchart,y 


Moltziple 3tatces 三 1 二 3) and 时 (二 20) aze boch bound to ?> (全 23) Thiae ia 3OC 


ELLORedG 


图 3.1.19 错误 提示 
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3.1.3 迁移 


1. 迁移 


Stateflow 状态 图 使 用 一 条 单 向 箭头 曲线 表示 迁移 , 它 将 两 个 图 形 对 象 连接 起 来 ,多 数 情 
况 下 ,迁移 是 指 系统 从 源 状 态 向 目标 状态 的 转移 。 

在 迁移 曲线 上 加 上 标签 ,可 以 指定 系统 在 何 种 条 件 下 从 源 状 态 向 目标 状态 转移 。 

如 图 3. 1. 20 所 示 , 当 系统 处 于 状态 Al 时 间 达 到 1 s, 即 向 状态 A2 迁移 。 


国光 和 吕 辆 


图 3.1.20 状态 迁移 
2.。 默认 迁移 

默认 迁移 是 一 种 特殊 的 迁移 形式 , 它 没有 源 对 象 。 默 
认 迁 移 用 于 指定 同一 级 有 多 个 互 斥 状态 并 存 时 ,首先 激活 
的 状态 。 

某 些 情况 下 ,默认 迁移 也 可 以 加 入 标签 ,限制 其 所 指向 
目标 状态 的 激活 。 

如 图 3. 1. 21 所 示 ,状态 Al 与 A2 是 互 斥 的 , 当 它 们 的 
父 状 态 A 激活 时 ,状态 Al 也 同时 激活 。 


3。 迁 移 标 签 
迁移 标签 的 完整 格式 如 下 , 它 可 用 于 一 般 迁 移 与 默认 迁移 ,如 图 3. 1. 22 所 示 。 


event[ condition ]{condition action}/transition_ action 


Fe 
全 
图 3.1.22 完整 的 迁移 标签 
各 字段 的 意义 如 表 3.1. 2 所 列 。 
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表 3.1.2 迁移 标签 字段 


8 引发 迁移 的 事件 条 件 动作 与 迁移 的 发 生 条 件 


(condition_action} | 当 条 件 为 真 时 ,执行 的 动作 |‖ /transition_action | 发 生 迁 移 ,进入 目标 状态 前 所 执行 的 动作 


(1) 事件 。 事 件 是 指定 迁移 的 触发 事件 。 如 果 用 户 另 行 指定 了 触发 条 件 , 则 当 条 件 为 真 ， 
且 发 生 该 触发 事件 时 , 即 发 生 迁 移 。 这 是 个 可 选项 ,如 果 用 户 不 指定 触发 事件 , 则 任何 事件 都 
能 够 引发 该 迁移 。 多 个 触发 事件 之 间 使 用 逻辑 或 运算 符 “| ”分隔 。 

如 图 3. 1. 20 所 示 , 当 条 件 after(1,sec) 为 真 时 ,触发 了 迁移 ,系统 状态 从 Al 变 成 A2。 

(2) 条 件 。 条 件 是 一 个 布尔 表达 式 , 当 它 为 真 时 ,一旦 发 生 指定 的 触发 事件 , 则 发 生 迁 移 。 
条 件 表 达 式 的 前 后 必须 使 用 方 括号 “[ ]" 包 围 。 

如 图 3. 1. 23 所 示 , 当 条 件 [ y>=3 为 真 时 ,发 生 迁 移 。 

(3) 条 件 动作 。 当 条 件 表达 式 为 真 时 ,立刻 执行 条 件 动作 。 若 事先 未 指定 条 件 , 系 统 则 假 
设 条 件 为 真 ,并 执行 该 条 件 动作 。 

如 图 3. 1. 23 所 示 , 当 条 件 [ y 盖 =3 为 真 , 条 件 动作 { y=10 } 立 刻 执行 。 

(4) 迁移 动作 。 当 迁移 目标 有 效 时 ,执行 迁移 动作 。 若 迁移 标签 由 多 个 字段 组 成 , 则 当 整 
个 标签 有 效 时 ,执行 迁移 动作 。 

如 图 3. 1. 23 所 示 , 当 条 件 [ y>=3 ] 为 真 , 且 目 标 状 态 B 有 效 时 ,发 生 迁 移 , 并 执行 迁移 
动作 z 一 20。 运 行 结 果 如 图 3. 1. 24 所 示 。 














A 日 
en'y= 
Display1 
站 Chart 
图 3.1.23 迁移 条 件 与 动作 图 3.1.24 输出 结果 
4. 迁移 有 效 条 件 


对 于 非 默认 的 迁移 , 当 源 对 象 处 于 激活 状态 且 迁 移 标 签 有 效 时 ,发 生 迁 移 ; 对 于 默认 迁移 ， 
当 其 父 状 态 被 激活 时 ,发 生 迁 移 。 
表 3.1.3 列 出 了 迁移 标签 的 有 效 条 件 , 用 户 可 以 根据 需要 ,选择 性 地 输入 迁移 标签 的 部 分 
或 全 部 字段 。 
表 3.1.3 迁移 标签 有 效 条 件 
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3.1.4 数据 与 事件 


3. 1. 1 所 示 的 数据 字典 中 ,数据 与 事件 是 合并 在 一 个 圆圈 内 的 ,这 表明 它们 有 相似 之 
处 ,本 节 对 它们 一 起 介绍 。 


1. 数 据 
数据 是 非 图 形 的 对 象 , 它 有 一 个 很 重要 的 特性 :作用 域 , 即 用 户 在 使 用 数据 时 必须 明确 定 
义 该 特性 。 


根据 作用 域 的 不 同 ,数据 可 分 以 下 8 种 : 
@ Stateflow 状态 图 本 地 数据 (Local) 。 
鳃 自 外 部 Simulink 模块 输入 的 数据 (Input from Simulink ) 。 
和 @@ 问 外 部 Simulink 模块 输出 的 数据 (Output from Simulink) 。 
@ 临时 数据 。 
@ 定义 在 MATLAB 工作 空间 的 数据 。 
@@ 常数 (Constant ) 。 
@ 问 Simulink 模型 与 Stateflow 状态 图 外 部 的 目标 (代码 ) 导 出 的 数据 。 
e@ 自 Simulink 模型 与 Stateflow 状态 图 外 部 的 源 代码 导 和 人 的 数据 。 
数据 的 简单 使 用 见 3. 2.4 小 节 。 
2. 事 件 
事件 也 是 非 图 形 的 对 象 , 它 驱 动 着 整个 Stateflow 状态 图 的 运行 。 如 同 数 据 , 事 件 同样 有 
它 的 作用 域 , 根 据 作 用 域 的 不 同 , 事 件 可 分 以 下 3 种 : 
(1) Stateflow 状态 图 本 地 事件 。 
(2) 自 外 部 Simulink 模块 输入 的 事件 。 
(3) 向 外 部 Simulink 模块 输出 的 事件 。 
事件 的 简单 使 用 见 3. 2.4 节 ; 事 件 的 分 类 见 3.5 节 。 


3. 动 作 


Stateflow 状态 图 支持 状态 动作 、 条 件 动作 、 迁 移动 作 。 这 里 所 说 的 动作 可 以 是 一 个 函数 
调用 广播 事件 .数学 运算 等 。 

例如 : 

盯 数 调用 :ml. log10(x) ;……… 

事件 广播 :Start; Stop……: 

数学 运算 :x 一 1;y 一 2;z 一 X 十 yj 


3.1.5 ”对象 的 命名 规则 


以 上 简要 介绍 了 常用 对 象 的 概念 ,用 户 可 以 使 用 任意 的 字母 ,数字 与 下 画 线 的 组 合 为 这 些 
对 象 命名 ,但 名 称 不 能 以 数字 开头 ,中 间 也 不 能 有 空格 。 


多 IO。 


国 基于 模型 的 设计 一 一 MCU 篇 


由 于 Real-Time Workshop 代码 生成 工具 的 限 WA 
制 ,对 象 的 名 称 不 能 超过 一 定 长 度 , 用 户 可 以 在 模型 Mean Wai 一 一 
人 参数 设置 对 话 框 的 Real-Time Workshop 一 Symbols 
面板 中 进行 修改 ,默认 的 长 度 是 31, 最 大 的 长 度 是 图 3.1.25 设置 对 象 名 称 的 长 度 
256 ,如 图 3. 1. 25 所 示 。 
表 3. 1.4 列 出 了 一 些 关 键 字 ,它们 是 Stateflow 动作 语言 的 组 成 部 分 ,因此 是 不 能 用 来 为 
对 象 命名 的 。 








表 3.1.4 关键 字 
关键 字 在 Stateflow 中 的 用 途 

hasChanged,hasChangedFrom,hasChangedTo 变更 监测 

complex，imag，real 复数 数据 

boolean，double，int8 ,jnt16 ，int32 ,single,uint8g，uint16 ，uint32 数据 类 型 

cast，fixdt， ES 3 数据 类 型 操作 

send 明确 事件 

change，chg，tick ，wakeup 旺 降 含 事件 

false，inf，true，t 标志 位 

matlab ，ml MATLAB 函数 与 数据 
bind， du，during，enyentry，ex，exit，on 状态 动作 

in 状态 激活 

after，at，before，everyy sec，temporalCount 时 间 逻 辑 


3.2 Stateflow 状态 图 


长 跑 人 比赛 时 ,通常 要 用 到 以 图 计 时 的 方法 , 它 的 意思 是 :计时 器 初次 开启 时 ,两 组 数码 管 皆 
清 零 ;运动 员 出 发 时 , 按 Start 按钮 开始 计时 ,数码 管 1 显示 实时 时 间 ; 第 一 次 回 到 起 点 ,表示 
跑 完 一 圈 , 这 时 按 LAP 按钮 ,数码 管 2 显示 当前 的 时 间 值 ,表示 一 圈 所 花费 的 时 间 , 但 比赛 仍 
在 进行 ,因此 计时 器 仍然 在 计时 ;再 次 按 Start 按钮 ,两 组 数码 管 还 是 显示 最 后 的 时 间 ; 第 三 次 
按 Start 按钮 ,两 组 数码 管 清 零 , 回 到 初始 状态 。 本 节 以 此 为 例 , 说 明 Stateflow 状态 图 的 建立 
过 程 。 


3.2.1 状 态 


1. 添加 状态 
新 建 一 个 空白 的 Stateflow 模型 , 单 击 “ 状 态 ” 按 钮 ,并 在 Stateflow 窗口 的 适当 位 置 再 次 
单 击 ,加 入 一 个 状态 ,如 图 3. 2. 1 所 示 。 
在 加 入 之 前 ,用 户 可 随时 按 ESC 键 ,或 再 次 单 击 按钮 ,取消 添加 。 
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图 3.2.1 添加 状态 


2. 状态 命名 


在 状态 矩形 框 左 上 角 的 编辑 提示 符 后 ,输入 状态 的 名 称 , 如 stop, 如 图 3. 2. 2 所 示 。 若 需 
要 修改 状态 名 ,可 将 鼠标 指针 移 至 名 称 附 近 , 待 鼠标 指针 变 成 编辑 样式 时 ,再 单 击 按钮 进行 修 
改 , 如 图 3. 2. 3 所 示 。 


| 
| 1 


图 3.2.2 状态 命名 图 3.2.3 状态 名 修改 


3. 添加 子 状 态 


将 鼠标 指针 移 至 状态 抢 形 框 4 个 角落 的 任意 一 个 ,调整 其 大 小 ,如 图 3.2.4 所 示 。 
再 按 步 又 1、2 ,添加 状态 Reset、Finished ,放置 在 状态 Stop 的 矩形 框 内 ,这 时 Stop 为 父 状 
态 ,Reset Finished 为 子 状态 ,如 图 3. 2. 5 所 示 。 


[Stop 





图 3.2.4 调整 状态 框 图 3.2.5 父 状态 与 子 状态 


3.2.2 迁移 


1. 添加 迁移 
将 鼠标 指针 移 至 源 状 态 矩 形 框 的 边缘 , 当 鼠 标 指 针 变 成 十 字 时 ,如 图 3. 2.6 所 示 , 按 住 鼠 


5 








直 基于 模型 的 设计 一 一 MCU 篇 
标 左 键 并 拖 向 目标 状态 的 边缘 ,然后 释放 ,如 图 3. 2.7 所 示 ，, 即 添加 了 一 个 迁移 。 





Finished 


| 
了 
SS 


图 3.2.6 迁移 起 点 图 3.2.7 迁移 终点 


2. 添加 默认 迁 移 
单 击 按钮 证 ,将 鼠标 指针 移 至 默认 状态 矩形 框 的 水 平 或 垂直 边缘 ,如 图 3. 2. 8 所 示 。 





图 3.2.8 选择 默认 迁移 


再 次 单 击 , 即 添加 了 一 个 默认 迁移 ,如 图 3. 2.9 所 示 。 
由 于 Stop 是 父 状态 ,还 需要 针对 其 中 的 子 状态 ,设置 默认 迁移 ,如 图 3. 2. 10 所 示 ,State- 
flow 的 层次 结构 详 见 3.4 节 。 


Stop 


S3 





图 3.2.9 添加 默认 迁移 图 3.2.10 添加 子 状态 默认 迁移 


3. 迁移 变更 
鼠标 指针 放置 在 迁移 的 起 点 或 终点 , 当 鼠 标 指针 变 成 圆圈 时 (图 3. 2. 11) , 按 住 鼠 标 左 键 ， 
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可 将 该 端点 移 至 其 他 状态 ,如 图 3. 2. 12 所 示 。 


Finished 





图 3.2.11 开始 迁移 变更 图 3.2.12 完成 迁移 变更 


将 默认 迁移 的 起 点 移 至 某 一 状态 , 即 转换 为 一 般 迁 移 ; 将 一 般 迁 移 的 起 点 悬空 , 即 转化 为 
默认 迁移 ,如 图 3. 2. 13 所 示 。 若 迁移 终点 悬空 , 则 该 迁移 无 效 , 如 图 3. 2. 14 所 示 。 






Siop 


网 
3 


Finmished 


图 3.2.13 迁移 起 点 变更 图 3.2.14 迁移 终点 变更 






Finished 





4. 迁移 标签 
新 建 的 迁移 标签 不 包含 任何 文字 信息 ,用 户 单 击 迁 移 曲 线 一 次 ,曲线 上 方 显 示 “?”, 如 图 
3. 2. 15 所 示 。 





图 3.2.15 添加 迁移 标签 
将 鼠标 指针 移 至 “?” 附 近 , 再 次 单 击 , 当 显示 编辑 光标 时 ,可 编辑 迁移 标签 ,如 图 3. 2. 16 


人 


基于 模型 的 设计 一 MCU 和 篇 


所 示 。 





图 3.2.16 编辑 迁移 标签 


完成 编辑 后 ,将 鼠标 指针 放 在 标签 的 任意 位 置 , 按 住 鼠 标 左 键 并 拖 动 ,调整 标签 的 位 置 , 如 
图 3. 2. 17 所 示 。 





图 3.2.17 移动 迁移 标签 


3.2.3 计时 器 状态 图 


根据 以 图 计时 的 特点 ,整个 系统 可 分 为 2 个 父 状 态 :停止 与 运行 。 停 止 状态 包含 2 个 子 状 
态 :计时 器 清 零 Reset .计时 器 停止 Finished; 运 行 状 态 也 包含 2 个 子 状 态 : 计 时 器 运行 Run- 
ning、 以 围 计 时 LAP, 如 图 3. 2.18 所 示 。 





图 3.2.18 添加 4 个 状态 
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再 根据 各 状态 之 间 的 联系 ,添加 默认 迁移 .迁移 以 及 迁移 标签 ,如 图 3. 2. 19 所 示 。 图 中 的 
迁移 标签 start 表示 单 击 start 按钮 这 个 事件 ,而 LAP 则 表示 单 击 LAP 按钮 。 





图 3.2.19 添加 迁移 及 迁移 标签 


3.2.4 数据 与 事件 


以 圈 计 时 需要 2 组 数码 管 显示 当前 以 及 记录 的 分 、 秒 、 百 分 秒 . 另 有 2 个 按钮 ,为 此 需要 添 
加 6 个 数据 与 2 个 事件 。 数 据 是 向 外 输出 的 ,而 事件 是 自 外 输入 的 。 

添加 数据 或 事件 的 方法 有 两 种 :使 用 菜单 项 Add 或 使 用 模型 浏览 器 (Model Explorer) 。 
前 者 的 优势 是 添加 方便 ,但 菜单 项 仅 提 供 了 添加 功能 ,无 法 通过 菜单 删除 已 添加 的 数据 或 事 


件 ,因此 本 书 推荐 用 户 使 用 模型 浏览 器 。 


1. 菜单 项 
在 Stateflow 编辑 器 窗口 ,选择 菜单 项 Add~Data 一 Output to Simulink ,如 图 3. 2. 20 


所 示 。 


Fle Edt Wew Smulation Tocks Format | add | Patterms Help 








区 园 马 5 和 和 和 和 叶 个 辐 Event ， 和 多 及 区 册 回 各 
Data Local... 





Stop Iarget.… Input from Simulink.… 


Reset Outputto Smulink... 人 N 
5 Gonstant,.， 
命 嫌 gemaameaeeotaaeageeapeE op 
Pararmeter..， 
Data Store Memory， :1 
| | | 4 区 


图 3.2.20 添加 输出 数据 
在 Name 栏 输入 输出 变量 名 min, 另 外 用 户 在 scope 栏 还 可 以 再 次 决定 变量 的 作用 域 , 如 
图 3. 2. 21 所 示 。 


Je 图 


0 


醒 : 基于 模型 的 设计 一 一 MCU 篇 


| 


General Value Attributes | Description 

Name: min 生 一 一 一 
人 ea Sea 

5cope: ta 2 
Local 

Data rmus Eee jobject 

Size Parameter Variable size 
Jnput 

Complexity: Output 一 


Type: double 


2. 模型 浏览 器 


Data Store Memory 


季 方 方 


Lock data type Setbng against changes by the fixed-point tools 


图 3.2.21 修改 数据 名 及 作用 范围 


在 Stateflow 状态 图 的 顶层 ( 即 不 选中 任何 图 形 对 象 ) ,选择 菜单 项 Tools 一 Explore, 或 直 
接 单 击 Stateflow 编辑 器 窗口 的 工具 栏 按钮 区 ,打开 模型 浏览 器 ,并 确认 已 选中 左 侧 模型 结构 
图 中 的 Chart 节点 ,如 图 3. 2. 22 所 示 。 


Bie Sa Jew Jocn ad Hop 
N 太 上 


折 


后] 涉 到 


yeer 才 。 by "see 柯 和 
mocm rom Ceamr vev tc ar ZERE Charc Chart 
| 。 划 Sevsne Feot em 5 Reyoive ah9ne Dotw 5 aa ee 
| 算 eewonn Madhre LedEel 2iags at 小 cz 
| a 区 mopwnw 
| 算 oae 5p< Estee 
总 Cogefer pyeaMcn_PIett Upoare method end 二 | SP Tawe: 
争 xdvmee fo sitepwatchn_pio 
淘 contiguration LUut 本 
二 Eve 人 operpoor APty 忆 逢 chen 
站 喇 Sop 
局 hese 矿 UL MeCh0d 1590 和 让 和 Son exeobon orger 
局 Dum Eport ChetLeve Geprca Funciona haie Gobal 
品 Phed YL ong De TYOng mi 由 ny NUD 
| ERUnm < 
口 Rurmnen3 
已 e te 
Sme Srch Reeos 


图 3.2.22 模型 浏览 器 


在 浏览 器 窗口 的 工具 栏 找到 按钮 后、 区 与 X'，, 添 加 一 个 数据 /事件 或 删除 对 应 项 。 在 中 


部 窗口 选中 数据 /事件 的 条 目 , 右 侧 窗口 即 显示 它 的 属性 ,如 图 3. 2. 23 所 示 。 与 菜单 项 方法 不 
同 的 是 ,使 用 浏览 器 添加 的 数据 /事件 ,默认 的 作用 域 是 本 地 (Local) ,用 户 需 要 手动 修改 为 外 
部 输入 或 外 部 输出 。 


Column View: |Statefow ”Yi ShowpDetails 1cf6cbiects ”Data min 
Name  Scope Port Resolye Signal DatafType Size Gener 引 Value Attributes | Desarption 
| 加 min Output 工 doubie Name; fin 
em En 
sope PE 
Local 
Data mus Constant 上 
Suze: Parameter | :Variable size 
Input 
Compiexity， 了 2 
Data Store MemoryY 
Type: double 四 
Lockx da type setbng asgamst danges by the fxed-point t 
寻 ? - 二 
[站 = = 一 -一 ee ee 
Revert | bep Apply 
Contents Search Resuits as 0 2 


有 图 3.2.23 利用 模型 浏览 器 修改 数据 
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对 于 事件 ,用户 还 需 指 定 它 的 触发 方式 ,Rising 表示 上 升 沿 .Failing 表示 下 降 沿 ,而 Ei- 
ther 表示 上 升 或 下 降 沿 皆 可 触发 ,本 例 的 两 个 输入 事件 start 与 LAP 皆 选 用 Either 方式 触 
发 ,如 图 3. 2. 24 所 示 。 





Event evVent 
Name: Start 


5cope: [mputfomSmuink >| Port [1 | Tooer' 上 







Debugger breakpoints， | | Startof Broadcast | ] EndolRising 


Description: Function ca 


Documentiink: 





|_Revert | tp iapy | 


图 3.2.24 利用 模型 浏览 器 修改 事件 


有 多 个 数据 或 事件 时 ,用 户 还 可 以 指定 它们 的 端口 号 ,合理 地 排列 这 些 端 口 , 将 有 利于 以 
后 的 Simulink 模块 连 线 。 图 3. 2. 25 所 示 是 完整 的 数据 与 事件 列表 。 








Column View: [statefow | Show Details ”8of13objects 
Name scope port Resol Datafype Tigger Size Ini 

了 富 min output 1 double 

[加 Se Output 2 double 

加 percent Output 3 医 double 

国 ] minbuf output 4 double 

| 曲 secbuf Output 5 [| double 

民 ] percentbuf Output 6 问 double 

| 努 stakt Input 1 Either 

| 光 LAP Input 2 Either 

1 4 计 RE 

Contents Sear 中 Resuils 


图 3.2.25 数据 与 事件 列表 


3.2.5 动 作 


上 文 提 到 ,显示 时 间 值 可 以 定义 为 状态 动作 ,也 可 以 定义 为 迁移 动作 。 为 不 失 一般 性 ,本 
小 节 分 别 说 明 这 两 种 动作 的 定义 方法 。 
计时 器 复位 时 ,两 组 数码 管 缘 应 清 零 ,因此 设置 子 状态 Reset 的 进入 动作 代码 如 下 : 


蒜 : 基于 模型 的 设计 一 一 MCU 篇 


Reset 

entrYy: 

min=0rsec=0;percent=0; 

minbuf = 0;Ssecbuf = 0;percentbuf = 0; 


单 击 LAP 按钮 或 再 次 单 击 start 按钮 时 ,数码 管 2 都 必须 显示 当前 时 刻 , 因 此 设置 子 状 态 
LAP 与 Finished 的 进入 动作 代码 如 下 : 


Finished 
entrYy: 

minbuf = mini 
Secbuf = Seci; 


percentbuf = percent; 


添加 了 动作 的 状态 图 如 图 3. 2. 26 所 示 。 


secbuf = SeC 


Centibuf = percent 。 
Le percentbuf = Percent 





图 3.2.26 动作 定义 在 状态 


当然 用 户 可 以 将 显示 时 间 值 定义 为 迁移 动作 。 为 此 按 图 3. 2. 27 调整 状态 图 ,添加 节点 与 
迁移 动作 。 对 照 图 3. 2. 26 ,用 户 应 很 容易 理解 图 3. 2. 27 的 意义 。 








Reset 
enfrmy 

9 一 | 。 rn=0.Sec=UJpercent=l 
rninbuf-USecbuf=; 
pefcentbuf=/ 


1 ye 一 -~ nm 福 
fninbt 帮 = FRI 
Secbhdf = Se 
pereefitbi = PerOept 








图 3.2.27 动作 定义 在 迁移 
不 过 目前 的 Stateflow 状态 图 还 缺少 最 关键 的 时 钟 程 序 ,该 过 程 详 见 3.3 节 。 
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3.2.6 自动 创建 对 象 


实际 建 模 时 , 随 着 思路 的 不 断 扩 展 与 成 熟 ,状态 .迁移 .数据 .事件 .动作 等 各 种 图 形 与 非 图 
形 对 象 , 总 是 交替 着 添加 ,很 少 按 照 上 述 过 程 逐步 进行 。 这 就 难免 发 生 遗 漏 ,尤其 是 大 型 .多 层 
次 的 Stateflow 状态 图 。 

当 用 户 完成 状态 图 的 编辑 , 单 击 “ 仿 真 ” 按 钮 时 ,系统 首先 要 进行 语法 检查 ,如果 发 现 错误 ， 
则 给 出 提示 。 如 果 是 某 些 数据 或 事件 未 定义 ,用 户 可 使 用 随后 出 现 的 Symbol Autocreation 
Wizard 向 导 ,自动 创建 缺失 的 对 象 。 

例如 ,用 户 可 以 在 图 3. 2. 26 中 任意 添加 一 个 状态 动作 y=1, 任 意 添 加 一 个 迁移 事件 
stop, 如 图 3. 2. 28 所 示 。 














Stop Run 
检 “< 厅 本 ” am 
人 Running 
entry -一品 entry'Y=:; 
rmIn=U SEC=U.percent= 
rminbuf=0 Secbuf=D percentbuU 仁 
\ ) 
上 
Finished LAP 
entry entry 
minbuf 本本 minbuf = min 
Secbuf = secbuf = SEC 
percentbuf = percent percentbuf = percent 
上 2 二 
克 
图 3.2.28 添加 一 个 状态 动作 
本 证 2 - ;五 了 本 “ 站 二 
单 击 “仿真 "按钮 ,系统 首先 给 出 语法 错误 提示 ,如 图 3. 2. 29 所 示 。 
Wew Font Size 
Ne55ag9e SoOurce Reported By Summary 
乱 parse Error Transie575) Stateflow Unresolved event stop in transttion stop {#573j) 
硬 parse Smror Running Stateflow Unre5ohed data Y in state Running f#556) 
| @ Parse Error  tOPwWatch proce355 Par5ec 
| 辐 Model er.，Unknown Simuliml Unresolved data 了 六 革 ate Runnimg fp556j | 
| | 
| 
| 
| 对 stopwatch_processfhart.Run,Tans(>573) 
| nzesclved evenz ,stop' In zara5ion etoRp ( 业 5723) 
epen ttetp Siose 
有 本 j 








图 3.2.29 错误 提示 


系统 进一步 分 析 该 语法 错误 ,是 由 于 状态 图 中 存在 无 法 处 理 的 符号 ,因此 弹出 Symbol 
Anutocreation Wizard 向 导 和 与 向 导 使 用 说 明 , 如 图 3. 2. 30 所 示 , 若 用 户 已 能 够 熟练 使 用 ,可 忽 
略 该 说 明 。 
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Symbol Autocreation Wizard 问 导 建议 应 另行 创建 数据 y 与 事件 stop ,如 图 3. 2. 31 所 示 。 
用 户 可 以 不 断 单 击 Scpoe 与 Proposed Parent 的 内 容 , 修 改 数据 /事件 的 作用 域 与 父 对 象 ， 
如 图 3. 2. 32 所 示 。 


Praesn0ived SyYmiDols 10uUpnd 站 StO0DWatch process (fachine) 
Place aa check by the datafevyents YOU Wish to CRE ETE Ifhe 了 fodel Explorer 


< 一 





Proposed Parent 






Parse， errors pre (hue 和 unresolved Symbols 站 








YOUr 出 agrarm(S) 次 stop Local Char tchart) 
因 》 Local Chart {chart) 
These types of errors 0ccur whhen appropriate 
dataievert oblects have not bean added ti the Mooel 
Explorer before parsing. 上 A "est guUess” has been ) 
made for You，Plesase do the following: | CheckwAE | UnCheckai __ Cancel | 
1]J Reyiew the listinthe Symbol Vizard. | 
2) Checkthe iems YOU wish to add 拉 
| 3) Click the 'Create' button 所 3.2.31 自动 创建 对 象 向 导 
量 
This will automatically create detalevent abjectsinthe | Jrrssohed symbels fodpd n. slopwalch_process mach 
Model Explorer which correspond to these unresoved Place 引 Check by he datalewents YOUWISh ti CREATE 站 站 ee 人 aodel Explorer 
Symbols . | 


Proposed Parent 





委 旭 5 和 ture dony Show th 恰 Biert 


六 stop stopwatch_process (machine} 
y pt Char 人 chart) 
区 


CheckA | UncheciwAw | “Cancei 


图 3.2.30 向 导 使 用 说 明 图 3.2.32 修改 作用 域 与 父 对 象 


用 户 若 接受 向 导 的 建议 , 则 单 击 数据 /事件 前 的 空白 处 ,选中 该 条 目 , 之 后 单 击 Create 按 
钮 ,创建 对 象 , 如 图 3. 2. 33 所 示 。 


Linresolvesd Symbols fund ip 杷 | Icess [machine} 
Place 3 Check by the datayevsrts VOD wish to CREATE in he 人 adel Explorer 






Proposed Parent 








六 stop stopwatch_process [machinej 
加 YY Output Chart fchart) 
愉 
Checkal | | uncheckau | _ create | | cancel |] 


图 3.2.33 创建 对 象 
3.3 Stateflow 流程 图 


3.3.1 流程 图 与 节点 


3. 1 节 与 3. 2 节 介 绍 了 Stateflow 状态 图 的 基本 概念 与 创建 过 程 。 状 态 图 的 一 个 特点 是 ， 
在 进入 下 一 个 仿真 步 长 前 , 它 会 记录 当前 的 本 地 数据 与 各 状态 的 激活 情况 , 供 下 一 步 长 使 用 。 
而 流程 图 只 是 一 种 使 用 节点 与 迁移 来 表示 条 件 、 循 环 ` 多 路 选择 等 允 辑 的 图 形 , 它 不 包含 任何 
的 状态 。 

由 于 迁移 (除了 默认 迁移 ) 总 是 从 一 个 状态 到 另 一 个 状态 ,节点 之 间 的 迁移 只 能 是 一 个 迁 
移 段 。 因 此 流程 图 可 以 看 作 是 有 若干 个 中 间 支 路 的 一 个 迁移 ,一旦 开始 执行 ,就 必须 执行 到 终 
节点 (没有 任何 输出 迁移 的 节点 ), 不 能 停留 在 某 个 中 间 节 点 ,也 就 是 说 必须 完成 一 次 完整 的 
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迁移 。 


从 另 一 个 角度 来 看 ,节点 可 以 认为 是 系统 的 一 个 判决 点 或 汇合 点 , 它 将 一 个 完整 的 迁移 分 
成 了 若干 个 迁移 段 。 因 此 可 以 将 几 个 相同 的 迁移 段 合 并 为 一 个 ,用 一 个 迁移 表示 多 个 可 能 发 
生 的 迁移 ,简化 状态 图 ,由 此 生成 的 代码 也 更 加 有 效 。 

对 于 以 下 情况 ,用户 应 首先 考虑 使 用 节点 : 

(1) if-else 判断 结构 . 自 循 环 结构 ,for 循环 结构 。 

(2) 单 源 状态 到 多 目标 状态 的 迁移 。 

(3) 多 源 状态 到 单 目标 状态 的 迁移 。 

(4) 基于 同一 事件 的 迁移 。 

注意 :事件 无 法 触发 从 节点 到 状态 的 迁移 。 

建议 :用 户 可 以 把 流程 图 封装 成 一 个 图 形 函 数 ( 详 见 3. 6. 2 节 ) ,便于 在 Stateflow 的 任意 
位 置 调用 。 


3.3.2 建立 流程 图 


1. 手动 建立 
建立 流程 图 的 过 程 与 建立 状态 图 的 过 程 相 似 , 以 一 段 简单 的 代码 为 例 ,手动 建立 流程 图 。 


if percent == 100 
{Percent = 0; 
sec= Sec+1;} 
else if sec == 60 
{sec=0j 
min=min+1;} 
end 
end 


(1) 起 始 节点 。 
单 击 按钮 浏 ,添加 起 始 节点 。 如 图 3. 3. 1 所 示 。 


愉 


图 圈 列 ele 图 


图 3.3.1 添加 节点 
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(2) 条 件 节点 与 终 节点 。 根 据 代 码 的 执行 过 程 , 逐 一 添加 条 件 节点 AL1、B1、Cl, 终 节点 
A2、B2, 以 及 节点 间 的 迁移 与 迁移 标签 ,如 图 3. 3. 2 所 示 。 


ipercent==100jipercent=0;Sec=SsSeC+1:} 





AT | EEC 二 本 和 
| tsec==60]{Sec=Dmin=minz1} 
六 生机 eeeneneeosre nameiccammnna sunuvns -nm En 9 四季 
Cf 
图 3.3.2 流程 图 
流程 图 运行 过 程 如 下 : 


@ 系统 默认 迁移 进入 节点 Al, 如 果 条 件 [percent == 100] 为 真 ,执行 {percent 一 0;sec 一 sec 
十 1;》 ,并 向 终 节 点 A2 迁移 。 

@ 如 果 条 件 Lpercent == 100] 不 为 真 ,向 Bl 节点 迁移 ,继续 判断 如 果 条 件 Lsec == 60] 为 真 ， 
执行 {sec= 王 0;min 王 min 十 1;)》 ,并 向 终 节 点 B2 迁移 ; 

曙 如 果 不 满 足 任何 条 件 , 则 向 终 节点 Cl 迁移 。 

(3) 节点 与 箭头 大 小 。 对 于 某 些 重要 的 节点 或 迁移 ,用 户 可 以 调整 其 节点 大 小 与 迁移 箭 
头 的 大 小 ,突出 其 地 位 。 例 如 ,选择 节点 Cl 的 右键 菜单 项 Junction Size 一 16, 如 图 3. 3. 3 所 
示 ，, 放 大 节点 ;选择 节点 Al 的 右键 菜单 项 Arrowhead Size 一 20, 放 大 指向 该 节点 的 所 有 迁移 
箭头 ,如 图 3. 3. 4 所 示 。 


各 
[percel Wake wa ， PEpercent==100]{percent=0:sec=sec+1 
内 2 | 7 rs A2 
sec==60]{sec= [sec==60]j{fsec=0min=min+1 4? 
局 日 2 B1 - eeveyepoeaeaiev 0 | B2 
Cf Ci 
图 3.3.3 节点 大 小 图 3.3.4 箭头 大 小 


(4) 优先 级 。 两 个 判断 节点 Al、.Bl, 均 有 两 条 输出 迁移 ,分 别 标记 了 数字 1、.2, 这 表示 迁 
移 的 优先 级 。 默 认 情 况 下 ,Statefiow 状态 图 使 用 显 性 优先 级 模式 ,用 户 可 以 自行 修改 各 个 迁 
移 优 先 级 。 

例如 ,选择 迁移 曲线 的 右键 菜单 项 Execution Order, 将 优先 级 由 1 降低 为 2, 如 图 3. 3, 5 
所 示 。 修 改 了 某 一 输出 迁移 的 优先 级 ,系统 会 自动 调整 同一 节点 另 一 迁移 的 优先 级 。 

为 避免 用 户 错误 地 设置 优先 级 ,Stateflow 提供 了 另 一 种 模式 ,; 隐 性 优先 级 。 和 选择 编辑 器 
菜单 项 File 一 Chart Properties, 取 消 勾 选 User specified state/transition execution order 复 
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选 框 ,启用 隐 性 模式 ,如 图 3. 3. 6 所 示 。 


Narne: chart 


? 双 全 
| Machine: (machine) junction 
| Ci 
Percent== 忆 册 Cepy EC State Machine Type: [Classic | 
两 站 A2 
Bac Update method: ; nhertted ”| Sample Time: 
SC 三 二 吕 关 瑟 它 人 _ 
Bf 了 Go To Parent 82 Enable C-bt operations Apply to 引 charts in machine now 
| Requwement # 
HDL Ceder User specified stateltransition execution order ) 
cy | | Export Chart Level Graphlcal Functions (Make Global) 
Font Srze 和 
L 
委 eadS y' Use Strong Dztn Typing with Simoufink IO 
吕 二 、 语 
3.3.5 迁移 优先 级 3.3.6 自动 设置 迁移 优先 级 


使 用 这 种 模式 时 ,系统 根据 以 下 规则 ,自动 设置 迁移 优先 级 ,从 高 到 低 排列 如 下 : 

J@O 既 有 事件 又 有 条 件 的 迁移 。 

G@ 仅 有 事件 的 迁移 。 

G@) 仅 有 条 件 的 迁移 。 

井 不 含 任 何 限制 的 迁移 。 

注意 :同一 个 Stateflow 状态 图 ,只 能 选用 一 种 优先 级 模式 ,但 对 于 有 多 个 状态 图 的 Simu- 
link 模型 , 则 不 受 此 限制 。 


2.。 自动 建立 


对 于 简单 的 流程 图 ,手动 建立 难度 不 大 ,而 对 于 稍 复杂 的 逻辑 ,用 户 难 免 会 感到 无 从 下 手 。 
Stateflow 提供 了 快速 建立 流程 图 的 向 导 , 它 可 以 生成 三 类 基本 逻辑 :判断 循环、 多 条 件 。 本 
小 节 使 用 向 导 ,重建 图 3. 3. 2 的 流程 图 。 

(1) 单 击 编辑 器 菜单 项 Patterns- 一 Add . .. ,选择 流程 图 的 类 型 ,如 图 3. 3.7 所 示 。 


Ple Edt Wenw Smulation TIools Format Add | Patterns | Help 


砂 园 秀 sa 克 | 中 二 十 | 之 本 | 丰 dd Decision 辐 
Add Loop 开 -Else,. 1 
Add Switch > 半 -Elseif 
上 dd custom 于 -Elseif-Else,,， 
Save Pattern 开 -Elseif-Elseif-Else,.， 
Niested- 于 ,， 





图 3.3.7 流程 图 向 导 菜 单 


(2) 这 里 选择 Patterns ~ Add Decision ~ If-Elseif-Else. ,. ,在 随后 打开 的 对 话 框 中 输 人 
判断 条 件 与 对 应 的 动作 ,如 图 3. 3. 8 所 示 。 
(3) 生成 的 流程 图 如 图 3. 3. 9 所 示 。 
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Description: 


上 Econdrtion: 
percent==100 


上 action: 
Percent=0'SeCc=Se6C+1: 


Elsef condition: 人 age 
sec==60 


Elseif action: rainm=minr+1 
sec=0min=min+t | 


呈 
aagpraeeaeeee -an 


Else action 


六 去 1 ee 


局。seeeeeeevorerovearo 


图 3.3.8 新 建 流程 图 对 话 框 图 3.3.9 流程 图 


3. 两 种 方式 的 对 比 


尽管 用 户 可 以 手动 建立 流程 图 ,但 使 用 流程 图 向 导 的 优势 也 是 显而易见 的 : 

(1) 任何 一 种 流程 图 都 可 归结 为 判断 .循环 、 多 条 件 ,或 者 三 者 的 组 合 , 因 此 皆 可 以 使 用 向 
导 自 动 生成 。 

(2) 使 用 向 导 生 成 的 流程 图 符合 MAAB(MathWorks Automotive Advisory Board) 规 则 ， 
这 有 利于 后 期 模型 检查 。 

(3) 各 种 流程 图 的 外 观 基本 一 致 。 

(4) 将 设计 好 的 流程 图 ,另存 为 模板 ,便于 重用 。 


3.4 层次 结构 


3.4.1 层次 的 概念 


Stateflowr 的 对 象 具 有 层次 性 ,一 个 Stateflow 对 象 可 以 包含 其 他 Stateflow 对 象 ,例如 状 
态 内 若 包 含 其 他 状态 , 则 形成 父 状态 ,其 内 部 状态 称 为 子 状 态 。 当 状态 具有 第 二 个 层次 时 , 状 
态 就 构成 了 层次 。 

状态 具有 了 层次 ,迁移 自然 也 具有 了 层次 ,Stateflow 允许 在 不 同 层次 状态 之 间 存 在 转移 。 
如 果 迁 移 穿越 了 父 状态 的 边界 直接 到 达 了 低层 次 的 子 状态 , 称 为 超 迁 移 。 

在 状态 图 中 使 用 层次 有 以 下 几 个 目的 ， 

(1) 使 用 层次 ,可 以 将 相关 的 对 象 组 合 在 一 起 ,构成 族群 。 

(2) 可 以 将 一 些 通用 的 迁移 路 径 或 者 动作 组 合成 为 一 个 迁移 动作 或 路 径 ,简化 模型 。 
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(3) 适当 地 使 用 层次 ,可 以 有 效 地 缩减 生成 代码 的 大 小 ,也 能 够 提高 程序 执行 的 效率 和 可 读 性 。 





3.4.2 迁移 的 层次 


1. 内 部 迁移 

内 部 迁移 是 指 从 父 状 态 边 缘 内 部 出 发 ,终止 于 子 状态 外 边缘 的 迁移 ,迁移 始终 处 于 父 状态 
的 内 部 ,不 会 退出 源 状 态 。 

在 交通 灯 系 统 中 ,同一 个 父 状态 PowerOn 存在 红 黄 绿 三 个 子 状 态 ,它们 需要 不 停 地 转换 ， 
但 除非 发 生 PowerOff 事件 ,不 会 退出 父 状 态 , 对 于 这 样 的 逻辑 过 程 , 读 者 可 能 习惯 使 用 节点 
将 三 种 状态 的 迁移 联系 起 来 ,如 图 3. 4. 1 所 示 。 

使 用 了 内 部 迁移 ,可 直接 从 父 状 态 激 活 相应 的 子 状态 ,不 必 经 过 节点 ,大 大 简化 状态 图 ,如 
图 3. 4. 2 所 示 。 


/ PowerOn 
Eee 上 PowerOn 
> Green 人 有 
| | 寻 同 | 























Red Yellow 














了 
一 一 一 一 -一 一 一 一 一 一 
PoOwe 

全 一 一 : 


fPowerOf 








图 3.4.1 带 有 节点 的 迁移 图 3.4.2 内 部 迁移 状态 图 


2. 层次 化 迁移 的 优先 级 
与 状态 类 似 , 迁 移 也 具有 层次 性 ,迁移 所 属 的 层次 是 由 其 父 状态 、 源 状态 和 目标 状态 决定 的 。 
因此 , 当 多 个 迁移 同时 有 效 时 ,Stateflow 需要 有 一 个 层次 化 迁移 优先 级 机 制 来 判断 迁移 顺序 。 
层次 化 迁移 的 优先 级 规则 为 :从 高 层次 到 低层 次 检测 ;从 外 部 迁移 到 内 部 迁移 检测 ;同一 
层次 内 , 超 转移 优先 。 
如 图 3. 4. 3 所 示 ,图 表 激 活 时 ,默认 迁移 激活 状态 A, 继 而 状态 A. al 被 次 级 默认 迁移 激 
活 , 这 时 按 以 下 优先 级 检测 迁移 是 否 有 效 : 

















F 
本 





图 3.4.3 层次 化 的 迁移 
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(1) 检测 高 层 A,B 状态 的 外 部 迁移 是 否 有 效 (eventl ,event2) 。 

(2) 检测 高 层 A,B 状态 的 内 部 迁移 是 否 有 效 (event3 ) 。 

(3) 检测 低层 al ,a2 ,bl 状态 的 超 迁 移 是 否 有 效 (event4) 。 

(4) 检测 父 状 态 A 内 部 子 状 态 间 的 迁移 是 否 有 效 (event5 ,event6 ) 。 


3.4.3 历史 节点 


在 状态 图 的 顶层 或 一 个 父 状 态 里 放置 一 个 历史 节点 , 它 便 能 记录 退出 父 状态 时 , 正 处 于 激 
活 状 态 的 子 状 态 , 当 再 次 进入 父 状态 时 , 则 默认 激活 上 一 次 所 记录 的 子 状态 ,而 不 是 激活 默认 
迁移 的 状态 。 

历史 节点 的 作用 域 仅 限 于 它 所 存在 的 层级 。 

如 图 3. 4.4 所 示 , 父 状态 A2 中 加 入 了 历史 节点 ,因此 当 第 1 次 激活 A2 状态 时 子 状态 C1 
被 激活 ,满足 迁移 条 件 时 C2 被 激活 ,但 此 后 A2 状态 向 Al 状态 的 迁移 将 优先 发 生 ,C2 状态 不 
再 向 C] 状态 迁移 。 于 是 第 1 次 激活 A2 状态 时 ,被 激活 的 子 状 态 是 C2 ,而 不 是 C1。 读 者 可 以 
从 图 3. 4. 5 所 示 的 输出 看 出 上 述 的 迁移 过 程 。 





图 3.4.4 历史 节点 图 3.4.5 运行 结果 
图 3. 4.6 与 图 3.4.7 人 此 详细 比较 两 者 的 区 别 。 





图 3.4.6 不 含 历史 节点 的 状态 图 图 3.4.7 运行 结果 


*JTIB，。 





第 3 章 Stateflow 建 模 与 应 用 攻 


3.4.4 子 状 态 图 


子 状 态 图 其 实 就 是 其 内 部 所 包含 的 状态 图 的 父 状态 。 用 户 可 以 像 操 作 父 状态 一 样 为 子 状 
态 图 定义 状态 动作 ,迁移 和 默认 迁移 。 与 Simulink 中 的 子 系统 类 似 , 子 状态 图 隐藏 了 模型 的 
细节 ,简化 了 图 表 。 

以 图 3. 4. 8 为 例 , 在 状态 A 中 右 击 ,在 右键 菜单 中 选择 Make Contents 一 Subcharted 命 
令 。 此 时 ,A 状态 变 成 了 灰色 ,隐藏 了 内 部 细节 ,成 为 子 状态 ,如 图 3. 4. 9 所 示 。 用 户 再 次 进行 
Make Contents-~>Subcharted 操作 , 则 可 取消 子 状 态 图 。 
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用 户 可 以 方便 地 在 各 层次 图 表 间 进行 切换 ,如 图 3. 4. 10 所 示 。 
EPE 一 > 


| Ele Edit View Simulation Tools Format Add Patterns Help > 
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图 3.4.10 子 状态 图 内 部 细节 
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3.4.5 层次 状态 图 中 的 流程 图 


流程 图 中 不 包含 任何 状态 ,也 不 保留 任何 状态 信息 。 流 程 图 一 旦 激活 , 即 由 默认 迁移 一 直 


运行 到 终止 节点 为 止 。 
如 图 3. 4. 11 所 示 , 当 状 态 A 处 于 激活 状态 时 ,B 事件 发 生 则 激活 状态 B, 这 时 便 执行 状态 
B 中 的 流程 图 ,并 且 只 执行 一 次 ,执行 完成 后 B 状态 仍 保 持 激活 ,直到 发 生 事件 A, 退 出 B 


状态 。 





or | 





* hh 





Am 


图 3.4.11 状态 中 的 流程 图 
3.5 并 行 机 制 


状态 可 分 为 两 大 类 : 互 斥 状态 exclusive (OR) 和 并 行 状 态 parallel (AND)。 若 在 同一 个 
层次 中 含有 多 个 互 斥 的 状态 ,状态 不 能 同时 被 激活 ,不 能 同时 执行 ,在 Stateflow 中 用 实 线 框 
表示 。 相 反 , 若 同一 层次 中 含有 多 个 并 行 状 态 , 则 一 旦 父 状 态 处 于 激活 状态 ,其 并 行 子 状态 同 
时 处 于 激活 状态 。 


3.S$.1 设置 状态 关系 


在 状态 图 编辑 窗口 的 空白 处 ,选择 右键 菜单 项 Decomposition 下 xclusive(OR ) 或 Parallel 
(AND) ,可 设置 顶级 状态 的 关系 。 如 图 3. 5. 1 所 示 ,状态 A 与 状态 B 是 并 行 的 。 

状态 关系 的 设置 仅 对 本 级 起 作用 ,尽管 状态 A 是 并 行 的 ,但 子 状态 Al、A2 仍 是 互 斥 
的 , 若 要 修改 ,用 户 需要 在 状态 A 和 抢 形 框 内 的 空白 处 , 右 击 , 选 择 菜单 项 Decomposition 一 
Parallel(AND) ,如 图 3.5.2 所 示 。 
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图 3.5.2 修改 状态 关系 


3.5.2 ”并行 状态 活动 顺序 配置 


处 于 同一 层次 下 的 所 有 并 行 的 状态 应 该 在 其 父 状 态 被 激活 的 时 候 同 时 被 激活 ， 四 


国 基于 模型 的 设计 一 一 MCU 篇 


的 激活 是 按照 一 定 顺 序 进 行 的 。 其 默认 激活 顺序 为 :从 上 到 下 ,从 左 到 在。 并 且 在 每 个 状态 的 
右上 和 角 用 数字 标注 ,如 图 3. 5. 3 所 示 。 

若 用 户 希 望 改变 其 激活 顺序 。 例 如 将 LED 状态 放 在 Fan 之 后 激活 ,可 以 先 选 中 LED 状 
态 ,在 右键 菜单 中 的 Excution Order 子 菜单 中 改变 激活 顺序 ,如 图 3. 5.4 所 示 。 


Patterns 


dd Note 
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Paste 


Go To Parent 
Regqulirements 
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图 3.5.3 默认 激活 顺序 图 3.5.4 改变 激活 顺序 


3.5$.3 本 地 事件 广播 


使 用 本 地 事件 广播 ,可 以 在 某 个 状态 内 部 触发 其 他 并 行 状态 的 执行 ,这 样 就 可 以 在 系统 的 
不 同 状 态 之 间 实 现 交 互 , 让 一 个 状态 的 改变 影响 其 他 状态 。 事 件 广播 可 以 触发 状态 动作 迁移 
动作 和 条 件 动 作 。 使 用 广播 之 前 ,需要 预先 定义 事件 。 

如 图 3. 5. 5 所 示 ,Led 状态 和 Fan 状态 为 并 行 关 系 。 


after(60 tick) 
0 人 


并 
一 一 一 一 一 人 en:edon 
个- 一 一念 
”afterl(30tick) 


图 3.5.5 本 地 事件 广播 
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(1) 当 父 状态 PowerOn 激活 时 ,Led. Off 状态 和 Fan. Off 状态 同时 被 激活 ,Fan. Off 状 
态 广 播 事 件 ledon ,于 是 Led. Off 状态 向 Led. On 状态 迁移 。 

(2) 当 Led. On 状态 满足 迁移 条 件 退 出 时 ,广播 事件 fanoff, 而 此 时 Fan. Off 状态 已 向 
Fan. On 迁移 ,于 是 响应 事件 fanoff , 回 Fan. Off 状态 迁移 。 


3.S$.4 直接 事件 广播 


使 用 直接 事件 广播 可 以 避免 在 仿真 过 程 中 出 现 不 必要 的 循环 或 递归 .并 能 有 效 地 提高 生 

成 代码 的 效率 。 
1. 用 send 函数 直接 事件 广播 

send 函数 的 完整 格式 为 :send(Cevent _name，state_name) ,使 用 该 困 数 进行 直接 事件 广 
播 ,如 图 3. 5. 6 所 示 。Stateflow 执行 过 程 如 下 : 

(1) 当 并 行 超 状 态 Led 和 Fan 激活 时 ,对 应 的 子 状态 Led. LI1 和 Fan. Fl 被 激活 , 子 状 态 
Led. L1 执行 状态 动作 flag 王 1。 

(2) Led. L1 至 Led.L2 的 迁移 条 件 Lflag 一 一 1] 为 真 , 于 是 执行 条 件 动作 send(Cevent_1l， 
Fan) ,向 状态 Fan 广播 事件 event 1, 由 于 状态 Fan 与 子 状 态 Fan. Fl 已 激活 ,Fan.Fl 到 Fan. 
F2 的 迁移 有 效 ,Fan.F2 被 激活 。 


vermnrrrnnrrnrnnnrrrnnrnnrnnrrnrrrnrrnnnnnrrrrnrrror--- 一 ~ 
ss 


L2 1 
全 [fag==1Hsendfevent 1 IF an) ; 
|enrflag=1， ; 


3.5.6 send 函数 直接 事件 广播 


2. 用 事件 名 直接 事件 广播 

将 图 3. 5. 6 稍 作 修 改 , 即 可 用 事件 名 直接 事件 广播 ,如 图 3. 5. 8 所 示 。 

(1) 除 事件 event_1 ,另行 定义 Fan 状态 的 本 地 事件 event_1。 

单 击 模型 工具 栏 图 标 妈 ,在 左 侧 model hierarchy 区 域 中 选择 状态 Fan, 单 击 add 一 ~ 正 - 
vent 按钮 ,为 Fan 状态 添加 本 地 事件 ,如 图 3.5.7 所 示 。 同 样 的 方法 可 以 定义 状态 的 本 
地 数据 。 

(2) 将 条 件 动 作 {send(Cevent_1,Fan) } 替 换 为 迁移 动作 /Fan. event 1。 

本 例 与 用 send 果 数 直接 事件 广播 的 区 别 在 于 : 

(1) event_l 属于 状态 Fan 的 本 地 事件 ,作用 范围 限制 在 该 状态 内 部 ,对 Fan 状态 可 见 ,对 
Led 为 不 可 见 。 
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| Add a Sateflow event 


图 3.5.7 定义 本 地 事件 
(2) 迁移 动作 Fan. event 1 替换 了 {send(Cevent 1,Fan) ) 。 





图 3.5.8 事件 名 直接 事件 广播 


3.5.5 隐 含 事件 和 条 件 


隐 含 事件 是 一 种 内 输 事 件 , 它 不 是 由 用 户 显 式 地 定义 或 触发 ,而 是 当 状 态 图 执行 时 就 会 自 
动 发 生 。 例 如 状态 图 被 唤醒 .进入 一 个 状态 .退出 一 个 状态 或 向 内 部 数据 对 象 赋值 。 隐 含 事件 
是 它们 发 生 时 所 在 的 状态 的 子 对 象 , 并 且 只 对 其 父 状 态 可 见 。 

使 用 隐 含 事件 和 条 件 有 助 于 简化 并 行 状态 之 间 的 依赖 关系 ,也 可 以 减少 数据 字典 中 定义 
的 事件 数量 ,降低 状态 图 的 复杂 程度 。 

表 3. 5. 1 列 出 了 隐 仿 事件/ 条件 的 表达 式 和 对 应 的 含义 。 
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表 3.5.1 各 降 含 事件 /条 件 及 其 含义 
隐 含 事件 /条 件 含 义 


对 指定 变量 (data_name) 写 人 数据 时 , 隐 含 地 产生 一 个 本 地 信和 号。 该 变量 不 能 为 
machine 的 子 数据 ,此 降 含 事件 只 对 Chart 或 更 低 的 层次 有 效 。 对 于 machine 的 子 数 
据 , 用 变化 监测 运算 符 决定 其 数据 是 否 改变 


change (data _name》 or chg 


《data_name) 


enter (state _name) Or en 


进 人 指定 状态 (state_name) 时 , 隐 含 地 产生 一 个 本 地 信和 号 


(state_narme) 


exit 《state_natne) Or ex( state_ 


退出 指定 状态 (state_name) 时 , 隐 含 地 产生 一 个 本 地 信和 号 


narmne) 
tick 评估 动作 所 在 的 状态 图 被 唤醒 时 , 隐 含 地 产生 一 个 本 地 事件 
wakeup 与 tick 相同 
[in(state_name)] 当 指 定 状 态 (state_name) 处 于 激活 状态 ,条 件 为 真 


如 图 3. 5. 9 所 示 ,Led 和 Fan 是 两 个 并 行 状 态 , 当 PowerOn 激活 时 ,状态 Led. Off 和 
Fan. Off 被 激活 。 当 隐 含 事件 tick 事件 广播 6 次 后 ,状态 Led. Off 向 状态 Led. On 迁移 ,状态 
Led. O 和 退出 ,广播 隐 含 事件 exit(Led. Off) ,于 是 状态 Fan. Off 向 状态 Fan. On 迁移 。 


PoweroOn 


aftert6 tick) 


afterf6 tick} 


exitfLed On) 


exittLed DO 





图 3.5.9 隐 含 事件 的 使 用 


3.6 Stateflow 其 他 对 象 


3.6.1 真 值 表 (Truth table) 


熟悉 数字 电路 的 用 户 ,一 定 了 解 表 3. 6. 1 所 列 的 异 或 门 真 值 表 。 


酸 习 基于 模型 的 设计 一 一 MCU 篇 


表 3.6.1 异 或 门 真 值 表 





由 于 在 Stateflow 中 , 真 值 表 的 表达 形式 为 条 件 , 决 策 和 动作 ,为 了 后 面 使 用 方便 ,可 将 异 
或 门 的 真 值 表 改写 为 表 3. 6. 2 的 形式 。 
表 3.6.2 异 或 门 的 真 值 表 改写 形式 


条 件 栏 输入 的 每 一 个 条 件 需 判断 真 假 , 判 断 完 结果 为 工 (逻辑 真 ),F( 逻 辑 假 ) 或 一 (逻辑 
真 或 逻辑 假 ) 。 当 所 列 的 条 件 满 足 某 一 决策 时 ,执行 该 决策 所 对 应 的 动作 ,而 动作 的 具体 内 容 
则 另外 在 动作 表 中 定义 。 默 认 决 策 定义 了 除 决 策 1 一 4 之 外 的 所 有 情况 。 

将 表 3. 6. 2 中 的 内 容 填 写 到 Stateflow 真 值 表 中 。 需 要 注意 的 是 动作 的 具体 内 容 在 Ac- 
tion Table 中 定义 ,并 给 每 个 动作 赋予 一 个 标号 ,在 Condition Table 的 动作 栏 引 用 动作 的 标号 
即 可 ,如 图 3. 6. 1 所 示 。 





”Description | condition 
a==04hb==0 





内 ctions: Spacify 提 | | 
row from the AL | 志 p| 直 | 人 二 
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se 图 3.6.1 建立 真 值 表 
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在 每 一 个 仿真 步 长 内 ,系统 首先 逐一 判断 各 个 条 件 的 输出 结果 ,将 输出 结果 组 合 起 来 ,再 
与 各 个 决策 逐一 比较 , 当 结果 完全 满足 某 一 决策 时 , 即 执行 对 应 的 动作 ,同时 不 再 判断 后 续 的 
决策 ,如 图 3.6.2. 图 3.6.3 所 示 。 





图 3.6.2 Stateflow 流程 图 图 3.6.3 Simulink 模型 


3.6.2 图 形 函 数 (Graphical function ) 


图 形 晒 数 是 用 包含 Stateflow 动作 的 流程 图 定义 的 函数 ,是 流程 图 的 延伸 ,使 用 图 形 方 式 
定义 算法 ,并 在 仿真 过 程 中 跟踪 它 的 运行 。 

图 形 郴 数 与 MATLAB 枉 数 、C 本 数 有 一 定 的 相似 之 处 ,例如 :图 形 函 数 同样 需要 接收 参 
数 并 返回 结果 ;用 户 可 以 在 状态 /迁移 动作 中 调用 图 形 函 数 。 不 同 之 处 在 于 图 形 晒 数 是 State- 
flow 自身 的 图 形 对 象 ,因此 可 以 直接 通过 Stateflow 编辑 器 创建 并 调用 ,不 必 像 文 本 函数 一 样 
需要 用 外 部 工具 创建 ,在 外 部 定义 。 

下 面 将 通过 图 形 函 数 完成 异 或 的 功能 ,使 读者 了 解 图 形 函 数 的 用 法 。 

(1) 先 创建 一 个 包含 Stateflow 图 表 的 Simulink 模型 ,然后 单 击 图 表 编 辑 器 中 图 形 工 具 
栏 的 图 形 函 数 按钮 冉 , 即 可 在 编辑 器 空白 位 置 添加 图 形 函 数 , 如 图 3. 6.4 所 示 。 
[ 面 Stetefow (fchar simolink fonctiom/Chart* 注 < 

1 
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图 3.6.4 添加 图 形 函 数 


(2) 单 击 ? 处 进入 编辑 状态 ,用 户 可 以 在 此 定义 所 需要 的 1uncbon ZXOrX y) 
函数 。 枉 数 名 的 语法 规则 为 :[Lnl,n2,n3…]= 王 函数 名 (al,a2， 
a3…)，, 其 中 nl,n2,n3 为 返回 值 ,al,a2,a3 为 参数 值 , 如 图 


3. 6. 5 所 示 。 
图 3.6.5 定义 函数 
其 *“I27， ; 
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(3) 用 户 可 以 在 图 形 琐 数 内 部 用 图 形 对 象 完 成 所 需 的 函数 逻辑 。 在 本 例 中 使 用 State- 
flow 提供 的 ielseif-else… 模 板 完成 函数 ,使 问题 更 加 简单 。 右 击 图 形 郴 数 ,选择 Pattern 一 
Add Decision~>If-Elseif-Else… 人 命令, 如 图 3.6.6 所 示 。 


用 mctiom Z=XOTIX 有 







Add Note Add Loop  ， 于 Else... 
Cut Add Switch ， 于 -Elseif,. 
Copy 页 dd Custom 环 -Elise 和 f-Else,， 
Paste Save Pattern 于 -Else 和 f-Elseff-Else.. 


Earl Nested-If,.. 


~ 一 ax 一 ww 一 一 一 


图 3.6.6 选择 逻辑 图 样 模板 
(4) 根据 3.6.1 节 的 内 容 不 难得 出 异 或 函数 的 实现 逻辑 。 在 Stateflow Pattern: IF-EL- 
SEIF-ELSE 对 话 框 中 完成 异 或 逻辑 ,如 图 3. 6.7 所 示 。 
(5) 单 击 OK 铵 钮 确认 后 ,自动 生成 实现 该 函数 的 图 形 函 数 ,如 图 3.6. 8 所 示 。 
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图 3.6.7 流程 图 对 话 椎 图 3.6.8 流程 图 


由 于 该 图 形 函 数 较 复 杂 ,可 以 先 将 图 形 完全 包含 在 函数 框 中 ,如 图 3. 6. 9 所 示 , 然 后 用 右 
键 菜单 中 的 Make Contents->subcharted 功能 简化 图 形 函 数 ,如 图 3. 6. 10 所 示 。 

(6) 图 表 添 加 相应 的 数据 .事件 后 ,就 可 以 通过 状态 动作 或 迁移 动作 实现 图 形 函 数 的 调用 
了 ,如 图 3. 6. 11 所 示 。 
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图 3.6.9 简化 图 形 函 数 图 3.6.11 调用 Stateflow 图 形 本 数 


3.0.3 了 mbedded MATITLAB 


Embedded MATLAB 函数 可 以 为 Stetaflow 添加 MATLAB 本 数 。 在 描述 算法 代码 方 
面 ,文本 形式 的 MATLAB 语言 比 图 形 化 的 Stateflow 动作 语言 更 加 优越 ,因此 ,必要 时 可 使 用 
Embedded MATLAB 函数 对 象 ,在 Stateflow 状态 图 里 添加 MATLAB 项 数 ， 

Embedded MATLAB 函数 是 MATLAB 语言 的 一 个 子 集 , 该 子 集 能 够 有 效 优 化 生成 代 
码 ,提高 代码 效率 ,为 编译 目标 生成 产品 级 C 代码 。Embedded MATLAB 函数 可 以 调用 子 项 
数 `. Embedded MATLAB 运行 时 库 函 数 .Stateflow 函数 以 及 部 分 MATLAB 函数 和 定点 工具 
箱 运 行 时 库 郴 数 。 

(1) 创建 一 个 包含 Stateflow 图 表 的 Simulink 模型 ,然后 单 击 图 表 编 辑 器 中 图 形 工具 栏 
的 Embedded MATLAB 范 数 按钮 圈 , 即 可 在 编辑 器 空白 位 置 添 加 Embedded MATLAB 郴 
数 , 如 图 3.6.12 所 示 。 
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3.6.12 添加 Embedded MATLAB 画 数 


洲 人 : 


喜 - 基于 模型 的 设计 一 一 MCU 篇 


(2) 单 击 “?” 处 可 以 编辑 Embedded MATLAB 函数 名 称 ,命名 规则 与 图 形 函 数 类 似 , 此 处 
命名 为 [len,area] 王 rectangle(length,width) ,如 图 3.6. 13 所 示 。 


eNf 
[enareaj=rectangletlength,width) 





图 3.6.13 Embedded MATLAB 函数 命名 
(3) 在 Stateflow 中 定义 4 个 数据 对 象 :length、width 为 柄 数 输入 ,len area 为 函数 输出 ， 
如 图 3. 6. 14 所 示 。 
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图 3.6.14 定义 数据 对 象 

(4) 双击 Embedded MATLAB 函数 对 象 ,打开 Embedded MATLAB 果 数 编辑 器 ,此 时 郴 
数 定义 行 已 定义 ,只 需 添加 算法 代码 即 可 。 

function [len,area] = rectangle(length,widthy) 

和 井 em] 

len =2* (length+ width); $% 计算 矩形 周 长 

area = length x* width # 计算 矩形 面积 

end 

关于 Embedded MATLAB 的 编写 与 调试 在 第 1 章 有 详细 的 介绍 ,这 里 不 再 更 述 。 

《5) 在 图 表 中 添加 默认 迁移 和 终止 节点 ,通过 迁移 动作 调用 Embedded MATLAB 函数 ， 
如 图 3. 6. 15 所 示 。 


vilenareal=rsctangietiength,width 六 


BAf 


Ben,areaj=rectangle(length,width) 





3.6.15 调用 Embedded MATLAB 函数 


”930。 
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3.6.4 图 形 盒 (Box) 


图 形 盒 是 Stateflow 的 一 种 图 形 对 象 , 可 以 用 来 组 织 图 表 中 的 图 形 对 象 。 添 加 图 形 盒 后 ， 
图 形 盒 中 图 形 对 象 的 可 视 性 以 及 并 行 状 态 的 激活 顺序 都 会 有 所 变化 。 

引入 图 形 盒 可 以 为 图 表 新 增 一 个 层次 ,因此 ,对 于 图 形 盒 外 部 的 对 象 来 说 ,图 形 盒 内 部 对 
象 的 可 见 性 发 生 了 变化 。 用 户 若 需要 在 图 形 盒 外 部 引用 位 于 图 形 盒 内 部 的 函数 或 状态 , 则 应 
该 在 引用 路 径 中 添加 图 形 盒 的 名 称 。 

引 人 和 人 图形 盒 会 改变 并 行 状态 的 激活 顺序 。 图 形 盒 内 部 并 行 状态 激活 顺序 为 从 上 到 下 ,从 
左 到 右 ; 若 图 形 盒 外 部 也 存在 并 行 状 态 , 则 图 形 盒 内 部 的 状态 优先 于 外 部 状态 激活 。 

图 形 盒 的 使 用 有 如 下 规则 : 

(1) 若 在 图 形 盒 外 部 引用 图 形 盒 内 部 的 函数 或 状态 ,必须 在 路 径 上 加 入 图 形 盒 的 名 称 。 

(2) 在 图 形 盒 内 部 可 以 添加 图 形 对 象 , 如 函数 、 状 态 。 

(3) 内 部 包含 若干 对 象 的 状态 可 以 转换 为 图 形 盒 。 

(4) 为 图 形 盒 添 加 数据 对 象 可 以 使 其 内 部 所 有 对 象 共 享 该 数据 。 

(5) 图 形 盒 及 其 内 部 对 象 可 以 打包 称 为 一 个 图 形 对 象 。 

(6) 图 形 盒 可 通过 subchart 功能 简化 其 内 部 元 素 。 

(7) 图 形 盒 无 法 定义 状态 动作 ,如 entry during 和 exit 动作 。 

(8) 无 法 定义 始 于 或 终于 图 形 盒 的 迁移 。 

在 Stateflow 编辑 窗口 中 单 击 图 形 盒 按钮 ,再 单 击 编辑 窗口 中 的 空白 处 即 可 添加 图 形 盒 。 
单 击 ?处 编辑 图 形 盒 名 称 , 如 图 3. 6. 16 所 示 。 

如 图 3. 6. 17 所 示 ,图 形 盒 命名 为 status, 其 中 有 两 个 Embedded MATLAB 函数 , 若 要 调 
用 msgCold, 其 语法 为 Status. msgCold() , 若 要 调用 msgWarm, 甚 语法 为 Status，。，msgWarm 
《Js 
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图 3.6.16 添加 图 形 依 图 3.6.17 调用 图 形 盒 中 的 对 象 


二 : 基于 模型 的 设计 -一 MCU 乱 


3.6.5 _ Simulink 函数 调用 


Simulink 函数 是 Stateflow 图 表 中 的 一 种 图 形 对 象 ,用 户 可 以 在 该 对 象 中 添加 Simulink 
模块 来 实现 预期 的 功能 ,并 在 状态 /迁移 动作 中 调用 ,从 而 实现 了 Simulink 与 Stateflow 间 的 
无 缝 连接 。Simulink 枉 数 通过 减少 图 形 和 非 图 形 对 象 的 方式 ,使 模型 设计 更 加 高 效 ,更 具 可 
读 性 。 

Simulink 苯 数 一 般 应 用 于 以 下 两 方面 : 

(1) 需要 用 到 lookup tables 等 Smujlink 模块 的 图 数 。 

(2) 多 控制 器 的 调度 执行 。 

Simulink 函数 的 调用 与 Simulink 模型 中 的 函数 调用 子 系统 模块 类 似 , 但 是 有 表 3. 6. 3 所 
列 出 的 区 别 。 

表 3.6.3 两 种 函数 调用 的 差别 


行 ”为 盟 数 调用 子 系统 Simulink 函数 


Simulink 函数 的 定义 位 置 则 决定 了 其 影响 范围 ,如 表 3. 6.4 所 列 。 
表 3.6.4 Simulink 函数 作用 范围 


调用 Simulink 函数 的 范围 ‖ Simulink 函数 定义 于 


以 下 说 明 Simulink 困 数 的 用 法 。 
(1) 创建 一 个 包含 Stateflow 图 表 的 Simulink 模型 ,然后 单 击 图 表 编 辑 器 中 图 形 工 具 栏 


的 Simulink 函数 按钮 园 , 即 可 在 编辑 器 空白 位 置 添加 Simulink 函数 ,如 图 3. 6. 18 所 示 。 





调用 Simulink 函 数 的 范 轩 
该 图 表 内 和 尼 可 调用 


Simulink 盯 数 定义 于 
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图 3.6.18 添加 Simulink 函数 
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(2) 单 击 ?” 处 进入 编辑 状态 ,用 户 可 以 在 此 定义 所 需要 
的 函数 。 函 数 命名 形式 与 图 形 函 数 相同 。 此 处 将 Simulink SUmURKA Cn 
函数 命名 为 x=sim_fun(a,b) ,如 图 3.6. 19 所 示 。 X=Sim_funl(a,b) 

(3) 双击 Simulink 函数 对 象 ,定义 Simulink 函数 的 子 系 
统 元 素 。 在 子 系统 中 有 与 命名 的 函数 对 应 的 输入 /输出 端口 
和 一 个 函数 调用 触发 端口 ,如 图 3. 6. 20 所 示 。 

向 模型 中 添加 模块 ,完成 图 3. 6. 21 所 示 的 子 系统 模型 。 注 意 应 保留 模型 中 的 触发 端口 。 

FERRCTTTCTECCILC -| 
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| Di 芒 回 必 | 本末; 中 了 | 了 习 |，? 触发 端口 


Er 





图 3.6.19 定义 函数 








| 一 
| | b 站 
| 125% ee ode45 Simulink 模 块 
图 3.6.20 打开 Simulink 函数 图 3.6.21 添加 模块 


(4) 定义 两 个 input from Simulink 属性 的 数据 对 象 作为 函数 的 输入 ;定义 一 个 output to 
Simulink 属性 的 数据 对 象 作 为 函数 的 输出 ,如 图 3. 6. 22 所 示 。 
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图 3.6.22 定义 数据 对 象 


(5) 向 图 表 中 添加 状态 ,并 定义 其 entry 动作 为 sim_fun(m,n), 则 当 该 状态 被 激活 时 , 即 
调用 Simulink 函数 sim_fun() ,如 图 3. 6. 23 所 示 。 


SLK FC7 
S Xx=Sim_fun(a,b) 





图 3.6.23 调用 Simulink 函数 
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二 基于 模型 的 设计 一 MCU 篇 


3.6.6 目 标 


目标 是 一 个 用 来 执行 Stateflow 图 表 或 包含 Stateflow 状态 机 的 Simulink 模型 的 程序 。 

若 用 户 并 不 想 为 具体 应 用 建立 快速 原型 或 产品 ,而 是 要 生成 其 独立 代码 , 则 可 以 使 用 代码 
生成 软件 Stateflow Coder 建立 用 户 目标 ,但 该 软件 生成 的 代码 并 未 经 过 RTW 的 优化 。 

(1) Stateflow 编辑 窗口 单 击 add->targets 会 弹出 用 户 目 标 对 话 框 如 图 3. 6. 24 所 示 。 
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图 3.6.24 用 户 目标 对 话 框 


在 Name 区 域内 输入 目标 名 称 并 设置 完毕 后 , 单 击 OK 按钮 即 完 成 用 户 目 标的 添加 。 
《2) 若 用 户 需要 进一步 修改 对 目标 的 配置 ,可 以 单 击 按钮 有 ,在 模型 浏览 器 中 进行 操作 。 
在 模型 浏览 器 的 Model Hierarchy 面板 内 选择 含有 用 户 目标 的 主 模型 ,然后 在 Contents 
面板 中 选择 目标 , 则 右 侧 的 动态 面板 即 出 现 用 户 目 标的 配置 对 话 框 , 如 图 3. 6. 25 所 示 。 
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图 3.6.25 用 户 目标 的 配置 对 话 框 
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(3) 用 户 目 标 配 置 对话 框 的 General 面板 内 可 做 如 下 设置 

人 User Comments in generated code: 在 生成 代码 中 包含 用 户 自 定义 的 注释 。 

人 Auto-generated Comments in generated code: 在 生成 代码 中 包含 自动 生成 的 注释 。. 

@) State/Transition Descriptions in generated code: 在 生成 代码 中 包含 状态 和 迁移 的 
描述 。 

四 Use bitsets for storing state configuration: 减 少 存储 变量 的 内 存 用 量 。 但 是 当 目 标 处 
理 器 不 包含 操作 bitsets 的 说 明 时 ,能 够 增加 存储 目标 代码 的 内 存 用 量 。 

人 @ Use bitsets for storing boolean data :减少 存储 布尔 型 变量 的 内 存 用 量 。 但 是 当 目 标 处 
理 器 不 包含 操作 bitsets 的 说 明 时 ,能 够 增加 存储 目标 代码 的 内 存 用 基 。 

人 @ Compact nested if-else using logical ANDVOR operators :通过 使 用 逻辑 运算 符 压 缩 多 
层 肉 套 的 itelse 结构 来 提高 代码 的 可 读 性 。 

例如 ,生成 代码 : 


if(Cc1l) { 
if(cl) !{ 
al(); 
} 
} 


被 表示 为 : 


if(cl 8&& c2) { 
al(); 
} 


@ Recognize if-else if-else in nested if-else statements :通过 使 用 ifelse if-else 结构 提高 
多 层次 艇 套 的 ielse 代码 的 可 读 性 。 
例如 ,生成 代码 : 


if(cl) { 
al(); 
}elseli 
if(Cc2) { 
a2() 
}elsel 
if(c3) { 
a3(); 
} 


} 
被 表示 为 


if(Ccl){ 
al(); 


梢 =135 二 : 
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}else if(c2) { 
a2(); 
}else if(Cc3) { 
a3(); 

} 


图 Replace constant expressions by a single constant: 通 过 对 常量 表达 式 估 值 , 用 单个 常 
量 代 替 常 量 表达 式 来 提高 代码 可 读 性 。 此 优化 功能 还 能 消除 无 效 代 码 。 
例如 ,生成 代码 : 


if(2+3<2) { 
al(); 
}else { 
a2(4+5); 
} 


被 表示 为 : 
if(0) 《 
al(); 
)}else { 
a2(9)j 
} 


G@) Minimize array reads using temporary variables :在 条 件 允 许 时 ,使 用 临时 变量 ,简化 数 
组 的 读 取 。 
例如 ,生成 代码 : 
alLi]j = foo(); 
if(a[i]<10&&a[i]<1) ! 
Y= aLij+5; 


aLi]j = foo(); 

temp = a[i]; 

if(temp < 10 &S& temp 二 1) { 
Y = temp+5i 

}else{ 
zZ = tempji 


} 


昨 Use chart names with no mangling: 保 留 图 表 entry 明 数 名 ,以 便 用 户 可 以 在 手写 C 代 
码 中 调用 。 勾 选 该 复 选 框 时 ,生成 代码 并 不 通过 mangle 图 表 的 名 称 来 使 其 唯一 化 。 由 于 该 复 
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选 框 不 检测 生成 代码 中 的 名 称 冲 突 性 ,因此 只 有 当 模 型 中 图 表 名 称 唯一 时 可 用 。 
@) I/O data format: 
a。Use global input/outpnut data :生成 图 表 的 输入 /输出 数据 并 作为 全 局 变量 。 
b。Pack input/output data into structures : 为 图 表 输 入 /输出 数据 生成 结构 。 
电 Generate chart initializer function :生成 数据 初始 化 画 数 。 
电 Multi-instance capable code: 生 成 多 实例 图 形 对 象 代替 静态 定义 。 
人 Build Options : 
a，Generate Code Only (non-incremental) :为 模型 中 的 所 用 图 表 生 成 代码 。 
b. Rebuild All (including libraries) :重建 目标 。 若 用 户 建立 目标 后 更 换 了 编译 器 或 更 新 
了 目标 文件 ,可 选择 该 选项 。 
c，Make without generating code: 调 用 创建 程序 ,但 并 不 生成 代码 。 


3.7 绽 合 应 用 


3.7.1 计时 器 


1.。 Stateflow 状态 


在 图 3. 3. 2 的 基础 上 ,添加 默认 迁移 的 事件 与 条 件 动 作 , 每 当 事 件 TIC 发 生 ,执行 {per- 
cent 一 percent 十 1 } ,之 后 再 判断 是 否 进 行 分 秒 进位 ,此 即 可 作为 一 个 计时 流程 。 事 件 TIC 
可 由 脉冲 模块 模拟 ,触发 条 件 为 上 升 沿 ,如 图 3.7.1 所 示 。 


TICfpercent=percent +1:} 


ipercent==100] 











{pefrcert=0， 
长 SeC=SeC+1 人 
《了 二 一) 


了 
{Sec=f0: 


min=rnin+r1} 








图 3.7.1 时 钟 流程 图 


为 了 实现 以 圈 计 时 的 功能 ,将 图 3. 7. 1 的 默认 迁移 起 点 , 移 到 父 状态 Run, 这 表示 只 要 
Run 处 于 激活 状态 ,就 不 断 执 行 计 时 流程 ,不 受 LAP 状态 的 影响 ,如 图 3. 7. 2 所 示 。 
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percerg=-Percert + 








Fimshed 

nbtf 
minbuf = rmn = 
secbuf = SeC 2 


Sec， 
percentbuf = Percert 








图 3.7.2 计时 器 状态 图 


2、Simulink 模型 


以 脉冲 模块 模拟 输入 时 钟 信号 ,两 个 开关 分 别 模拟 Start 与 LAP 按钮 , 按 图 3. 7. 8 建立 
Simulink 模型 。 由 于 每 个 Stateflow 模块 只 能 有 一 个 事件 输入 口 ,有 多 个 外 部 输入 事件 时 , 必 
须 使 用 Mux 模块 将 它们 组 合成 向 量 。 水 平 放置 的 Mux 模块 ,其 输入 端口 号 从 左 往 右 对 应 事 


件 端口 号 ,而 垂直 放置 的 Mux 模块 ,其 对 应 关系 则 是 从 上 到 下 。 
在 Simulink 模块 库 中 找到 图 3. 7. 3 一 图 3. 7. 7 所 示 模 块 ,并 按 图 3.7. 8 所 示 连 接 。 


扩 - Ports 8& Subsystems 


上 SignalAttrtbutes 
|- Signal Routing9 


- User-Defmed Funchons 


| Pulse Generstcr 
+-Addiktionai Math & Discrete 


+- 吕 Aerospace Bockset 


让 


+ “ 遇 Aerospaces Blodeset 


图 3.7.3 脉冲 发 生 器 模块 


| 


Mux 


|~Ports & Subsystems 
Signal Attributes 

| 一 Sinks 

一 Sources 

ij-User-Defined Functions 

+ -Additional Math SDscrete 


图 3.7.5 合 路 器 模块 


最 | Gauges Blockset 

| 后 -GlobalMajcactiveX Library 
- Angular Gauces 

| “Democ 上 rcra 和 jnstruments 
[~ LEDs 

~- Linear Gauges 


广 SignalRoutin9 

-Sinks 

|- Sources 

| 上 - User-Defned Functions 

| 机 AddiionalMath& Discrete 
机- 哆 Aerospace 6ockset 

+ 蝎 Communicatbons Biockset 


| 


图 3.7.4 常数 模块 


Signal Attributes > 

Sional Routing AN 
> 一 

Sources 

User-Defined Functons Manual Switch 


| 机 Additonal Math & Discrete 
+- 盘 | Aerospace Biodeset 


图 3.7.6 手动 开关 模块 


| 


旧 
Generic NumericLED 


| 
| 
| } 


rr 


图 3.7.7 数字 LED 模块 
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Pulse 
Generator 


Real Time 





Chast 





图 3.7.8 功能 验证 模型 
双击 Start 开关 ,系统 开始 计时 ,如 图 3.7.9 所 示 。 


Start 
Pulse 
Generator 


Real Time 





玫 厂矿 厂 | 广 页 
了 | 呈 


图 3.7.9 开始 计时 
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双击 Lap 开关 ,系统 记录 当前 计时 值 ,并 继续 计时 ,如 图 3. 7. 10 所 示 。 





Statt 


Lap 





Chatt 


图 





图 3.7.10 以 圈 计 时 
再 次 双击 Start 开关 ,系统 停止 计时 ,显示 最 后 计时 值 , 如 图 3.7. 11 所 示 。 






Pulse 
Generator 


Real Jime 


图 3.7.11 最 后 计时 值 


aa 
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3. 创建 GUI 界面 


利用 Simulink 模块 库 提供 的 开关 模块 ,已 能 实现 本 例 的 功能 ,但 若 模型 需要 大 量 的 开关 ， 


必然 导致 常数 模块 或 连 线 间 的 交叉 点 增多 ,人 为 地 使 得 模型 变 得 复杂 。 为 此 使 用 GUI 用 户 图 
形 界面 ,简化 模型 ,同时 提高 仿真 的 舒适 度 。 


MATLAB 的 GUI 界面 与 VC VB 等 软件 的 类 似 , 因 此 本 文 仅 叙 述 创建 过 程 , 不 作 功 能 介绍 。 
(1) 删除 图 3. 7. 8 模型 的 开关 以 及 常数 模块 ,另外 新 增 常 数 Start 与 Lap , 按 图 3. 7. 12 所 
示 调 整 。 


Real Time 





Chart 





LapTime 


图 3.7.12 调整 功能 验证 模型 


(2) 选择 MATLAB 界面 的 菜单 项 File~>New~>GUI, 在 打开 的 对 话 框 中 选择 GUI 模板 
为 Blank GUI, 勾 选 下 方 的 Save new figure as… 复 选 框 , 指 定 GUI 文件 名 ,并 确保 文件 路 径 与 
Simulink 模型 的 一 致 ,如 图 3. 7. 13 所 示 。 


Create New GUI | Open Baqsting GUI 
GUIDE termplates Preyview 
| Blank GUIDefaudb 
| 大 GUI with Uicontrols 
| 委 GUI with Axes and Menuw 
| 二 Modal Quoestion Dialcg 


yj| Save newfigure a5 GMATLAB\bookiStateflow\stopwatchvunt 


一 王 -一 一 一 一 一 mass 
| 1 Cancel | 





图 3.7.13 新 建 GUI 界面 选项 
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(3) 确定 后 ,系统 打开 GUI 编辑 窗口 与 回调 函数 编辑 窗口 ,如 图 3. 7. 14 和 图 3. 7. 15 所 示 。 


Pie Edt Wew Layou IIoolks Hep Fle Edit Jet Go Seal Toos Debug Desktop indow Hep 忆 
可 本: 关 二 区 阅 ee 帅 靶 印 才 | 司 国 驶 ; 本 请 :区 让 力 亿 有 了 的 和 相公 四- 介 站 才 鲍 车 准 几 
[ 司 <“ 号 形 0 ;yi + ix 速生 
革 让 function Varargout = Untitliedl (vararglri) ] 
国 | 吓 4 TEST 0 DO 50T RDE 
= 5 
筷 | 吕 ， 站 
| er | 条 SYS 访 AHte 1 玉 避 贡 MEiE 
~- 广 =- 4 funcrion UntITTIedI_OpernirEgFcrhobjeact， wentdat 二 jiardles， Yasrargirn) 
3 昌 | 归 
本 | 国 对 和 AT 人 As 33608 wa Or VSeF WeSDO1Y se DRESIERES 
1 全 本 
P 到 8 
AS 有 一 一 = 2 9 “TIR “DSS 《ETTOT fw YePWUI7140 CUDOA 1 六 
抱 fnvct20n Varargout = Wit1sdi_OutputEcnihobiect，eyverrtdar3a，handlas) 
， < 高 
Tagx,， Current point [了 5 255 Position: 上 520. 544 305 256] Untitled1 Lan 好 Col 4 


图 3.7.14 GUI 编辑 窗口 图 3.7.1s 回调 函数 编辑 窗口 


(4) GUI 编辑 窗口 里 加 入 两 个 按钮 ,如 图 3.7. 16 所 示 。 
(5) 双击 按钮 ,修改 属性 对 话 框 String 栏目 的 内 容 , 将 显示 文字 修改 为 Start/Reset 与 
LAP ,如 图 3.7.17 所 示 


大 


验 | 交 | 1 
二 SliderStep [ol0d] 


了 村 天 区 车 趾 攻 罗 枯 | 铝 攻 驳 庆 Sn Start/Reset 





起 
Styie pushbutton 轰 
Tag Pushbuttonl 灰 an 
TooltipStnng 中 SedReset | 
UIContextMenu < 村 one> 区 
[一 
了 [| 公 上 生 : 
6 SliderStep Io0i03j] 有 
sng 有 7 
Styie pushbutton = 
Tag Pushbutton2 三 
- ” ToclipString 三 
Tag-。 Cumentpoint 1304.71| posftionc[520 544 305 256| UIContextMenu “None> * 


图 3.7.16 添加 按钮 图 3.7.17 修改 String 栏目 显示 文字 内 容 


(6) 选择 Start/Reset 按钮 的 右键 菜单 项 View Callbacks->Callback ,系统 自动 定位 到 回 
调 函 数 编辑 窗口 的 对 应 位 置 ,并 高 亮 显示 ,如 图 3.7. 18 所 示 。 





File Ed Jed So Sel To Debog Descp Wondew Hop 四 
] 二 竹 ; 上 由 动 本 二 习 的 和 哮 及 有 辣 克 克 区 革 温 - 
呈 鹃 | = 1* +33 汪 她 

P soseao writemainmns cq 

1 本 
全 

二 Bxeovtres oF USYGN PuUeES 2 pignbw 

从 fctian JS COALIE9CR SObyarX， 必 9ty 直 由 二 na) 

人 阳 Ye asdTe 人 3 Ttshbs 攻 +of ， CC 

18 5 证 了 ~ 六 记 

3 

31 

各 

33 E ea 二 na 

funcr3on pshbuttorn albackihDbect，emert tnta，handas3 
| 8 甘 
全 龟 NafhctLE 和 scYITEE 习 hh As 1 


untitiedl / Pushbutoni Cabs LiLn 刀 《ol 


图 3.7.18 编辑 回调 函数 
人 2 光一 要 
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《7) 添加 StartReset 按钮 的 回调 方法 代码 如 下 ,其 中 stopwatch_state 表示 模型 名 称 , 用 
户 应 按 实际 调整 。 


function pushbutton1l_Callback(hobject，eventdata，handles) 
start = Str2num(get_param(" stopwatch state/Start '，'Value'")) ; 
if start == 0 

Start = 1; 
else 

Start = 10; 
end 


set_param(" stopwatch_state/Start'，' Value'，num2str(start) ) ; 


同样 的 方法 ,添加 LAP 按钮 的 回调 方法 代码 如 下 : 


function pushbutton2_Callback(hObject，eventdata，handles) 
Lap = str2num(get_param(" stopwatch state/Lap'，'Value1); 
if Lap == 0 

Lap = 1; 
elSe 

Dap=0i; 
end 


set_param(" stopwatch_state/Lap '，' Value '，num2str(Lap) ) ; 
《8) 单 击 GUI 界面 编辑 器 的 工具 栏 按钮 各; ,执行 该 GUI, 如 图 3.7. 19 所 示 。 
加 :topwatch El 机 近 抽 | 





E3 





图 3.7.19 执行 GUI 


这 时 Start/Reset 与 LAP 按钮 即 可 实现 原先 的 开关 功能 ,即使 不 运行 模型 , 单 击 这 两 个 按 
钮 ,模型 窗口 的 Start 与 Lap 常数 模块 的 数值 已 能 够 实时 变化 。 

《9) 选择 Simulink 模型 窗口 的 菜单 项 File~>Model Properties ,在 Callbacks 选项 卡 的 
PostLoadFcn 条 目 ,添加 文字 stopwatch, 如 图 3. 7. 20 所 示 。 这 样 重新 打开 模型 窗口 时 ,GUI 
界面 即 可 自动 打开 。 


六 “143。 】 
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3.7.2 交通 灯 


Main 
| Model callbacks 
一 PreLoadFcn 
| 一 InitFcn 
| StartFcn 
:PauseFcn 
上 ContinueFcn 


1 Stateflow 状态 图 


Callbacks History | Description | <^ 
Model post-load 和 nction: = 


stopWatch 





3.7.20 Callbacks 选项 卡 


一 个 小 型 路 口 的 交通 灯亮 灭 过 程 可 以 用 以 下 文字 简单 表示 :南北 向 禁 行 时 红 灯 亮 起 并 保 
持 50 s, 同 时 东西 向 通行 ,绿灯 亮 起 ,但 只 保持 45 s,45 s 时 东西 向 缓行 , 黄 灯亮 起 ,保持 5 s; 之 
后 东西 向 禁 行 , 红 灯 亮 起 并 保持 50 s, 同 时 南北 向 通行 ,绿灯 亮 起 ,同样 只 保持 45 s,45 s 时 南北 
向 缓行 , 黄 灯 亮 起 ,保持 5 s, 如 此 循环 反复 。 


用 户 根据 上 述 各 节 的 介绍 ,应 能 快速 地 建立 图 3. 7. 21 所 示 的 简单 交通 灯 状 态 图 。 





1 人 可 


图 3.7. 21 


简单 交通 灯 状 态 图 
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图 中 4 个 状态 RedNorthSouth YellowEastWest、RedEastWest、 YellowNorthSouth 分 别 
代表 南北 向 禁 行 、 东 西向 缓行 、 东 西向 禁 行 、. 南 北向 缓行 。 变 量 nsred.nsyell .nsgreen .ewred、 
ewyell .ewgreen 分 别 代表 南北 向 与 东西 问 的 红 灯 、 黄 灯 、 绿 灯 , 在 不 同 的 状态 中 ,它们 的 亮 灭 
以 1 或 0 表示。 

简便 起 见 , 可 以 设置 任意 一 个 状态 作为 默认 迁移 状态 , 进 ehf 
入 该 状态 时 , 便 开 始 倒数 计时 ,显然 处 于 不 同 的 状态 ,每 个 方 人 
向 的 倒数 计时 起 始 值 是 不 一 样 的 :例如 红 灯 50 s、 黄 灯 5 s、 绿 
灯 45 s。 在 Stateflow 状态 图 中 ,添加 一 个 Embedded MAT- 


LAB 函数 time(flag) 实 现 该 功能 ,如 图 3. 7. 22 所 示 , 代 码 图 3.7.22 Embedded MATLAB 


如 下 : 函数 time(flag) 

function time(flag) 

timeout = 0; $ 计时 终了 标志 清 零 

switch flag sg 判 断 当 前 所 处 的 通行 状态 

case 1 % 南北 向 禁 行 时 
nssec = red; % 取 变 量 red 作为 南北 向 计时 起 始 值 
ewsec = green; % 取 变 最 green 作为 东西 向 计时 起 始 值 
Sec = green# 10; $% 提高 计时 精度 ,放大 倒数 计时 变量 

case 2 $ 东西 向 缓行 时 
ewsec = red-greeni # 取 变 量 red-green 作为 东西 向 计时 起 始 值 
sec = (Ted-green) * 10; 

case 3 $ 东西 向 禁 行 时 
ewSec = red; $ 取 变 量 red 作为 东西 向 计时 起 始 值 
nssec = greenj; #% 取 变 量 green 作为 南北 向 计时 起 始 值 
Sec = green# 10; 

case 4 sg 南北 向 缓行 时 
nssec = red-greeni # 取 变 量 red-green 作为 南北 向 计时 起 始 值 
sec = (Tedgreen) * 10; 

end 


读 取 了 计时 起 始 值 , 即 开始 倒数 计时 ,这 里 沿用 3.7. 1 节 的 计时 流程 图 , 稍 作 改 造 并 封装 
为 图 形 函 数 count() , 供 各 状态 调用 ,如 图 3. 7. 23 所 示 。 每 当 事 件 TIC 发 生 ,倒数 计 时 变量 
sec 减 1, 当 sec 王 0 时 ,计时 终了 标志 timeout 置 1, 状 态 应 发 生 迁 移 。 


刀 PpcaOom COUE 


DCfsec--} 
1 


[remamn(secj==0 





图 3.7.23 图 形 函 数 count( ) VE 
各 …- "45。 ， 
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为 了 提高 计时 精度 ,函数 time(flag) 曾 将 计时 变量 sec 
ef 放大 了 10 倍 , 只 有 当 计 时 变量 的 个 位 为 0 时 , 才 表 示 计 得 1 
秒 ,南北 向 、 东 西向 的 计时 值 才 可 以 减 1, 因 此 需要 用 到 取 余 
y=remain(x) 函数 rem() 。 不 过 在 流程 图 的 迁移 条 件 里 不 能 直接 使 用 该 函 
数 , 为 此 将 其 封装 成 Embedded MATLAB 枉 数 remain(x)， 
如 图 3.7. 24 所 示 ,代码 如 下 : 
图 3.7.24 Embedded MATLAB RE 


函数 remain(x) Y = renm(x,10); 


状态 迁移 过 程 如 图 3. 7. 25 所 示 。 
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nsgreen= nsgreen=0; 

人 ewWred=D0- 
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一 2 二 te 人 1 





本 5 an 时 如 meout==3] 
忆 
RedEastWest YellowEastWest 
en:nsred=0: 2 二 errnsred=:; 
nSye 有 0: 
nsgreen=f0: 
Pmeout==: ewred=0: 


| ewWye 人 = 
eWgreen=DU- 
PE (2 





图 3.7.25 状态 迁移 过 程 
完整 的 状态 图 如 图 3. 7. 26 所 示 。 


RedNorthSouth eAf GAf 
eninsred=:; 
fmelfiag) =remain(X) 


nsgreen=D 





ewWred=1: 
eWyell=1 外 Pheott== 1 |] 


ewgreen=n0 
， 加 mcfiorm COUTE 





ifsec-- 


fmeout==1 | 


RedEastWest 





ewgreen=0 
Yi 





图 3.7.26 完整 的 状态 图 
图 3.7.27 列 出 了 整个 Stateflow 状态 图 的 所 有 变量 与 事件 ,南北 向 .东西 向 的 三 萤 指 示 灯 
以 及 计时 值 nssec\ewsec 均 设 置 为 输出 变量 ,而 状态 标志 flag、 计 时 变量 sec. 计 时 终了 标志 
timeonit 只 需 作 为 内 部 变量 ,TIC 作为 时 钟 信号 触发 类 型 选 为 上 升 沿 。 


0 
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| Name Scope 
图 eWred Output 工 doubile 
天 ewyeh Output 2 double 
民 j] ewgreen Output 3 double 
下 司 nsred Output 4 double 
[ 国 ] nsye8 Output 5 ”double 
局 j] nsgreen Cutput 6 double 
了 [ 锐 nssec Dutput 7 double 
] ewsec Output 8 double 
BE 涪 fae Local double 
洛 se Local doubie 
[ 问 timeout Local double 
[ 问 red Input 1 double 
国 ] green Input 2 double 
区 Input 1 

图 3.7. 27 


2. Simulink 建 模 


Rising 





Port Dataype TWggew Se Initialvalue CompiledSize Compiled 


变量 与 事件 列表 


完成 Stateflow 状态 图 之 后 ,在 Simulink 模块 库 中 找到 图 3. 7. 28 一 图 3.7. 31 所 示 的 模 


块 , 添 加 到 模型 。 


| ports & Subsystems 

| sonaateutes 

目 上 Signal Routing 

Sinks 

| EC 下 

| |- User-Defined Functions 
熙 -Addiional Math 8 Discrete 
+ 易 | Aerospace Biockset 


图 3.7.28 脉冲 发 生 器 模块 


iports & Subsysters | 
上 Signal Attributes 


Sources 
| | -User-Defined Functons || 
| 机 -Addiional Math &Discrete | 
H- 遇 Aerospace Blockset | 


Miux 


mm 


图 3.7.30 合 路 器 模块 


Pulse Generatcr 


[ 
+ 


和 


- 各 AErospace Blockset 


ee Routing 
“Sinks 
~User-Defned Functions 
[ dditional 届 ath 8 Discrete 
. 现 Aerospace Blockset 
遇 communications Bicckset 


Constant 


图 3.7.29 常数 模块 


|.-ports & Subsystems 


敬 Se 四 
-User-Defined Functions Goto 


+-Additional Math & Discrete 


| 


3.7.31 Goto 模块 


按 图 3. 7. 32 连接 ,任意 设置 常数 red 与 green 的 值 , 例 如 10.7, 这 代表 红 灯 与 绿灯 的 点 亮 


时 长 。 


继续 在 模型 中 添加 图 3. 7. 33 一 图 3. 7. 36 所 示 模 块 。 


.147。 ; 


配 - 基于 模型 的 设计 一 一 MCU 篇 





蕊 hs 入 


3.7.32 Stateflow 部 分 模块 连接 





; 江 Model-Wide Utilities 六 | Model-Wide U 需 ties 本 
| |-Ports & Subsystems | Ports 8 Subsystems | 
| 斑 :上 -Signal Attributes | 
| 了 | Snks 
四 Sources 
iirUser-Defined Functions RE | 上 User-Defined Functions Demux 
| 出-Additional Math 8 Discrete | 市 .Additional Math &Disaete | 
H- 出 | Aerospace Blockeset _ 让 4 嚼 Aerospace Blodeset =| 
图 3.7.33 ”From 模块 图 3.7.34 分 路 器 模块 


- 鞭 Fuzzy Logic Toolbox 


本- 从 Gauges Blockset er 、 最 GaugesB| 人 
| 三 'Global Majc 六 ctiveX Library | 中 -Global Majic ActiveXLibrary  -| 
| "Angular Gaug9es | Angular Gauges 5 
DemoAircraftinstruments [ “Demo Aircra 代 Instruments 


和 er 
| | 和 一 Linear Gauges | ”GenericNumericLED 





iLinear Gauges | 本 NmnericDisplavs 
| “Numeric Displays 了 |- On DO 他 Gauges 
图 3.7.35 红色 方块 模块 3.7.36 数字 LED 模块 


该 状态 图 的 连 线 过 多 ,如 果 仍 使 用 连 线 直 接 相 连 , 必 导致 图 形 杂 乱 无 章 , 信 和 号 流向 难以 分 
辨 。 使 用 From Goto .Demux 模块 ,可 以 大 大 地 简化 图 形 ,如 图 3.7. 37 所 示 。 

Red Rect 模块 若 不 作 任 何 修改 , 它 只 能 显示 红色 ,用 户 可 以 根据 需要 设置 模块 的 背景 色 、 
外 框 . 亮 灯 颜色 . 灭 灯 颜 色 等 ,如 图 3.7. 38 .图 3.7. 39 所 示 。 
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Red ”Yellow Green 





图 3.7.37 显示 部 分 模块 连接 








图 3.7.38 修改 红色 方块 模块 的 背景 色 图 3.7.39 修改 红色 方块 模块 的 亮 灭 色 


南北 、 东 西 两 向 的 倒数 计时 最 多 为 两 位 十 进 制 数 , 因 此 设置 数码 管 其 显示 位 数 为 2 位 整 
数 .0 位 小 数 , 如 图 3.7. 40 所 示 。 





图 3.7.40 修改 数字 LED 模块 的 显示 位 数 


国 :; 基于 模型 的 设计 一 MCU 篇 


3。 模 型 设置 及 仿真 
选择 模型 主 窗口 的 菜单 项 Simulation 一 Configuration Parameters …， 如 图 3. 7. 41 所 示 ， 
打开 模型 参数 对 话 框 , 如 图 3. 7. 42 所 示 。 


Fle Edt Wew 上 Simulation | Format ITools Help 






Start Ctrl*T 儿 Nom 
Configuration Parameters,， 人 N CtrsE | 
Y _ Normal 
Accelerator 
Rapid Accelerator | 


Software-in-the-Locp [SIU) 
Processor-in-the-Ltoop {PILL) 


Edternal | 


图 3.7.41 模型 参数 设置 菜单 








Select: Simulation time 
于 
中 | Starttime: 0.0 Stop time:; 10.0 
| 上 Data jmportWyExport 
| Opimization | Solkver options 
| 守 -Diagnostics | -一 一 -一 -一 一 一 一 一 一 一 一 
| | Sample Time | Tipe' [Eyedsep | Sover' Ldiscrete (no continuous states) 了) 
| | 六 Data Varty | Flxed-step stze (fundamental sample bme): 0.01 
| | Type Comversson 
| | Connectvtty | 
| 1 Compatioilty 了 askng and 5ample bme options 
| | Model Referencing Periodic sample time constraint: funconsraned m| 
| 1 二 Saving 人 区 生 作 竺 人 作 全 作伪 人 
| | statefow Tasking rmmode for perlodic sample times: LAuto 5 | 
| Hardware Implementation ; 六) Automatically handle rate transition for data transfer 


| 一 Model Referencing 

=-Simulation Target 
| -~ Symbols 
mm 


上 于 Higher priorty value indicates higher task priority 


图 3.7.42 参数 设置 对 话 框 
在 Solver 界面 中 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 3.7.43 所 示 。 
Solver options 


Type: [Foed-step  “] sover | dscrete (no contnuous statesj .| 
Fixed-step Size (fundamental sample time): 0.01 0 








图 3.7.43 求解 器 设置 


双击 脉冲 发 生 器 模块 ,根据 实际 需要 设置 脉冲 周期 与 脉冲 宽度 ,如 图 3.7.44 所 示 。 
完成 以 上 设置 后 执行 仿真 ,模型 即 按 设计 开始 运行 ,如 图 3.7. 45 一 图 3. 7. 48 所 示 。 


: .150 
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Parameters 


Pulse type: [rime based 说 


Time (D: |use smulatontme 了 ] 


中 





Amplitude: 
上 

Period (secs): 

5 

Pulse Width (9%e of periody》: 
10 


Phase delay (secs)}: 


0 


局 Interpret Vector parameters 3a5 1-D 


图 3.7.44 脉冲 发 生 器 参数 
6| East Wesl 


ee Red Red 、 

PR | CR 
了 Yellow rev | 居 | -~ 

so Green Km] 


[ ge 
Red Yegow Green 




















图 3.7.45 南北 向 禁 行 图 3.7.46 东西 向 缓行 


Red YEiow Green 


Red 


图 3.7.47 东西 向 禁 行 图 3.7.48 南北 向 缓行 


人 


第 4 章 
设备 驱动 模块 的 编写 





基于 模型 设计 的 核心 是 系统 模型 ,如 图 4. 0. 1 所 示 ,而 模型 又 是 由 一 个 个 的 模块 组 成 ,其 
他 部 分 如 验证 与 测试 .设计 仿真 等 只 是 保证 该 系统 模型 能 正常 工作 的 手段 。 尽 管 MathWorks 
公司 为 MATLAB 用 户 提 供 了 一 千 多 个 预定 义 模块 和 一 些 算 法 ,同时 诸多 必 片 厂家 也 为 各 的 
芯片 开发 了 设备 驱动 模块 ,但 仅仅 依靠 这 些 现 有 模块 还 不 能 解决 所 有 的 实际 问题 。 即 使 能 用 
这 些 基本 模块 组 成 应 用 系统 ,但 该 系统 结构 复杂 ,存在 改 一 点 而 动 全 身 的 问题 ,给 系统 升级 带 
来 麻烦 :同时 ,系统 的 运算 速度 也 因 存 在 大 量 的 中 间 数 据 交换 而 受到 限制 。 用 户 创建 自己 的 设 
备 驱 动 模块 ,是 基于 模型 设计 必须 掌握 的 基本 技能 ,也 是 难点 和 核心 内 容 之 一 。 





4.0.1 基于 模型 设计 的 核心 


创建 设备 驱动 模块 的 方法 一 般 是 使 用 C MEX S-function 和 Embedded MATLAB。Em- 
bedded MATLAB 比较 容易 上 手 ( 已 在 第 1 章 介绍 ), 不 过 它 目前 支持 的 函数 还 不 太 多 ,应 用 受 
到 一 定 的 限制 。 本 章 将 重点 介绍 用 C MEX S-function 创建 用 户 自 定义 设备 驱动 模块 的 方法 ， 
包括 noninlined Sfunction 和 Inlined S-function 模块 。noninlined S-function 模块 主要 用 于 
系统 仿真 (RTW 也 可 为 其 生成 C 代码 ) ,而 Inlined S-function 模块 则 为 模块 产生 嵌 人 式 实时 
C 代码 。 

本 章 主 要 内 容 如 下 : 

外 建立 简单 的 SFunction 模块 。 

@@ SFunction 与 SFunction Builder 原理 。 

@ 应 用 。 


: 生 528 一 一 - 
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4.1 创建 S 泪 数 模块 的 示例 


本 章 主 要 介绍 如 何 创建 用 户 设备 驱动 模块 ,而 编写 C MEX S 函数 是 一 项 很 有 挑战 性 的 工 
作 。 为 了 帮助 读者 在 现 有 的 知识 水 平 下 ,尽快 熟悉 设备 驱动 模块 的 编写 方法 ,我 们 按 弃 了 传统 
的 从 理论 指导 实践 的 方法 ,采用 自然 的 认 知 过 程 一 一 从 感性 认识 到 理性 认识 。 本 节 利 用 一 个 
简单 的 例子 一 一 算术 乘法 , 辐 读 者 展示 S 函数 的 各 种 编写 方法 ,同时 让 读者 产生 一 些 疑 问 和 思 
考 , 针 对 这 些 问 题 ,在 后 续 小 节 逐 一 解答 。 

现 有 的 算法 大 多 数 已 用 C 语 言 实现 了 ,并 得 到 了 广泛 的 应 用 ,对 于 这 些 经 过 验证 的 C 代 
码 , 用 户 没 有 必要 重新 编写 。 因 此 合理 正确 地 利用 现 有 的 C 代码 ,可 加 快 S 范 数 的 编写 。 

集成 C 代码 编写 S 果 数 的 方法 有 以 下 3 种 : 

(1) 手工 编写 Wrapper S 函数 :这 是 最 直接 且 最 灵活 的 方法 ,但 这 需要 用 户 详细 了 解 S 困 
数 的 结构 与 S 函数 的 API 函数 (回调 方法 )。 如 果 要 生成 内 联 S 函数 的 代码 ,还 需要 TLC 
(Target Language Compiler) 文件 ,编写 过 程 难度 较 大 。 

(2) 利用 SFunction Builder 生成 S 辆 数 :这 是 最 简单 且 最 直观 的 一 种 方法 ,用 户 可 以 
不 需 事先 了 解 $ 函数 的 结构 与 API 晒 数 ,当然 如 果 用 户 具 备 这 些 知识 ,使 用 起 来 更 会 得 
心 应 手 。 它 同时 可 以 生成 TLC 文件 ,用 以 生成 内 联 S 函 数 的 代码 。 不 过 SFunction 
Builder 调用 的 API 函数 只 是 S 晒 数 API 的 一 个 子 集 , 因 此 生成 的 S 郴 数 ,功能 受到 一 定 
限制 。 

(3) 使 用 代码 继承 工具 (Legacy Code Tool,LCT) 创 建 S 函数 模块 :代码 继承 工具 事实 上 
是 一 组 MATLAB 命令 ,命令 的 参数 对 应 着 S 机 数 的 各 个 字段 ,因此 要 求 用 户 应 事先 了 解 S 郴 
数 的 基本 结构 。 与 SFunction Builder 一 样 ,LCT 工具 也 可 以 生成 TLC 文件 ,但 它 所 调用 的 
API 贤 数 较 SFunction Builder 来 得 更 少 。 

本 节 以 现 有 的 C 代码 doublelt. c 为 例 ,说 明 整 合 现 有 C 代码 ,创建 Sfunction 模块 的 3 种 
方法 : 

double doubleIt(double u) / /doubjleIt.c 

{ 


returnCu # 2.0); 


} 


4.1.1 手工 编写 Wrapper S 函数 


由 于 手工 编写 Sfunction 需要 事先 了 解 它 的 结构 ,因此 本 节 仅 简要 说 明代 码 意义 ,4.2 节 
将 详细 介绍 S-function 的 结构 。Wrapper S 函数 的 原理 如 图 4. 1. 1 所 示 。 


往 -…- - “153 人 ， 


有 3 基于 模型 的 设计 一 盖 MCU 篇 


Simulink ReaFTime Workshop 
ee 生成 的 代码 wrapperc 调 用 


mdlOutputs 方法 ， 而 
mdlOutputs 方法 调用 my _alg 











wrapper.C 
qdlouputs(.) 


如 果 S 函 数 没有 相应 






















人生 
S 函 数 调用 mdiOutputs 的 TLC wrapper 文 } 人 
方法 ， 而 mdlOutputs 方 件 ， 则 在 生成 的 代码 
法 调用 my_alg 中 调用 mdiOutputs 
WwWrapsfcn.Cc 在 TLC wrapper 
mdIlOutputs(.) 中 ，wrapper .exe 的 
mdlOutputs 方 法 调 
my_alg(); “jjmy_alg 肯 数 
} 
在 wrapsfcn.mex 中 
mdlOutputs 调用 外 my-ag .5 
部 函数 my_alg 


人 _Tmy algreal T U 


y=ftu): 


图 4.1.1 Wrapper SS 函数 的 原理 


1. 手写 CMEX S 函数 代码 
若 读 者 暂时 不 能 理解 代码 中 的 注释 ,可 留待 后 期 了 解 了 相关 内 容 再 回来 阅读 。 





井 define S_FUNCTION_NRME wrapsfcn /1/ S 函数 名 

井 define S_FUNCTION _ LEVEL 2 // S 枯 数 的 级 别 为 2 

井 include "simstruc.h” 

extern real T doubleIt(real Tu); // 声明 外 部 函数 

// 模型 初始 化 

static void mdlInitializeSizes(SimStruct x*S)1{ 
ssSetNumSFcnParams(S，0); // S 函数 参数 个 数 为 0 
sSsSetNumContStates(S，0) ; // 连续 状态 个 数 为 0 
ssSetNumDiscStates(S，0) ; // 离散 状态 个 数 为 0 


// 如 果 输 入 口 个 数 不 为 1, 则 返回 

if (!ssSetNoumInputPorts(S，1)) returnj 
ssSetInputPortWidth(S，0，1) ; // 第 一 个 输入 口 维度 
ssSetInputPortDirectFeedThrough(S，0,， 1);// 第 一 个 输入 口 为 直 馈 
// 如 果 输 出 口 个 数 不 为 1, 则 返回 

让 (1ssSetNumOutputPorts(S,1))》 return; 
ssSetOutputPortWidth(S，0，1); // 第 一 个 输出 口 维度 
SSsSetNumSampleTimes(S，1) ; // 采样 率 个 数 为 1 


ra 
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} 


qiprreee are rectrre mr 


// 采样 时 间 初 始 化 

static void mdlInitializeSampleTimes(SimStruct #*S)1{ 
ssSetSampleTinme(S，0，INHERITED SAMPLE TIME) ;// 采样 时 间 为 继承 
ssSetOffsetTime(S，0，0) ; // 采样 时 间 偏 移 量 为 0 

} 


// 模型 输出 

Static void mdloutputs(SimStruct *S，int tidy! 
InputRealPtrsTYPe uPtrs = SSsGetInputPortRealSignalPtrs(S,0); 
real T *#*Y = ssGetOutputPortRealSignal(S,0); 
#*Y = doubleIt( * uPtrsl 0D]); // 调用 外 部 函数 

} 


// 模型 结束 

static void mdljTerminate(SimStruct * S){ 
UNUSED_ARG(S) ; 

} 


# ifdef MRTLAB MEX_ FILE // 此 5 行 代码 ,一 般 不 应 删除 
坷 include "simulink.c” 

井 else 

# include "cg_sfun.hy” 

并 endijf 


将 doublelt. c 保存 在 wrapsfcn. c 同 -- 目 录 下 ,在 命令 行 输入 以 下 代码 ,编译 该 S 函数 。 


mex WIapsfcn.c doubleIt.c 


2. 功能 验证 模型 
新 建 一 个 Smulink 模型 ,并 加 入 一 个 S$ 函数 模块 ,如 图 4.1.2 所 示 。 


-Signal Attributes 
一 Signal Routing 
Sinks 
一 Sources SySste 站 多 
LEFT 
科 - Addiional Math & Discrete 
+- 黄 Aerospace Blockset SFunction 
+ -网 communications Biockset 
一 了 Control Svstem 和 olbox v 


图 4.1.2 S 函 数 模块 
设置 其 对 应 的 S 图 数 名 为 wrapsfcn, 如 图 4. 1. 3 所 示 。 注 意 , 该 函数 名 不 包括 任何 扩 
展 名 。 
在 该 模型 里 继续 添加 信和 号 源 .增益 .示波器 等 模块 ,如 图 4.1.4 所 示 。 


关 


基于 模型 的 设计 一 一 MCU 篇 





S-function ne(eapse ) Ed 汶 


5S-function parameters: 


S-function modules: ” 





图 4.1.3 设置 S 函 数 名 图 4.1.4 功能 验证 模型 


单 击 “ 仿 真 ” 按 钮 ,示波器 显示 S 函数 输出 结果 与 增益 模块 的 一 致 , 说 明 S 函数 实现 了 设计 
的 功能 ,如 图 4.1.5 所 示 。 


研一 一 会 照 结果 





图 4.1.5 输出 结果 


3。TLC 文件 


为 了 能 够 使 用 Real-Time Workshop(RTW) 代 码 生 成 工具 ,定制 系统 模型 的 实时 C 代码 
生成 过 程 , 必 须 创 建 内 联 的 S$ 函数 ,这 时 还 需要 手写 TLC 文件 。 

以 下 是 wrapsfcn. c 对 应 的 TLC 文件 wrapsfcn. tic, 其 中 BlockTypeSetup 末 数 为 double- 
It.c 声明 了 一 个 函数 原型 ,Dutputs 琐 数 则 告诉 RTW 代码 生成 工具 如 何 将 doubleIt. c 函数 作 
为 内 联 晒 数 调用 。 


负 implements "wrapsfcn""C” 


和 外 Function: BlockTYPpPeSetup 


秽 和 Abstract; 
第 第 Create function PrototVpe in model.h as: 
币 第 " extern double doubleIt(double u) 祖 


g% function BLockTYPeSetup(blcock ，sSYstem) void 


: 呈 56， 一生 
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外 openfile buffer 

争 币 ASSIGNMENT :， PROVIDE ONE LINE OF CODE AS 玉 FUNCTION PROTOTYPE 
extern double doubleIt(Cdouble u) ; 

% Closefile buffer 

负 < 工 ibCacheFunctionPrototype(buffer)> 


gg endfunction 





币 多 Function: Outputs 

先 第 Y = doubleItCu ); 

$ function Outputs(block，system) Output 
/# 币 <TYpe> Block: 要 <Name> #/ 
争 asslign u = LibBlockInputSignal(0，"”",，" "，0) 
% assign Y = LibBlockOutputSignal(0,，""，""，0) 
外 凶 PROVIDE THE CRLLING STRTEMENT FOR " doubleIt，” 
<Y> = doubleIt( $%<u> ); 


第 endfunction 


4.1.2 代码 继承 工具 (Legacy Code Tool) 


代码 继承 工具 ,可 以 较 快 地 将 现 有 C 代码 生成 一 个 S 函数 模块 , 它 的 工作 原理 如 图 4. 1.6 
所 示 。 





代码 继承 工具 〈LCT) 
、 初 始 化 LCT 数 据 结构 
指定 LCT 数 据 结构 

3、 生 成 S-function 源 文件 
4、 编 译 S-function 源 文件 

5、 创 建 封 壶 的 S-function 模 块 


己 有 的 C 代 码 与 头 文件 









人 






N 












doubleitLc doubielth 






生成 的 S 函 数 模 块 


double y1 = doublelt(doutle u 


jegacy_wrapsfcn 






图 4.1.6 代码 继承 工作 原理 
1，LCT 脚本 


将 doublelt. c 与 doubleIt. h 放 在 同一 目录 下 ,运行 以 下 脚本 ,系统 将 创建 一 个 带 有 S 函数 
模块 的 Simuiink 模型 ,并 编译 一 个 名 为 legacy_wrapsfcn. c 的 S 函数 ,再 生成 对 应 的 TLC 文 
件 legacy_wrapsfcn. tlc。 


和 


名 : 基于 模型 的 设计 一 一 MCU 篇 


def = legacy_code(' initialize ); #% 创建 LCT 数据 结构 

def. SourceFiles = 1 doubleIt.c? ; 负 指定 C 源 代码 

def. HeaderFiles = 1 们 doubleIt.h? ); 负 指定 C 头 文件 

def. SFunctionName =“1Tlegacy wrapsfcn $ 指定 S 函数 名 

def. DutputFcnSpec = double l = doublelIt(double ul) ;gs% 指定 输出 函数 
def. SampleTime = [一 1;0|; # 指定 采样 时 间 为 继承 
legacYy_code(" slblock_generate '"，def); g 生成 S 郴 数 模块 
legacy_code(' sfcn_cmex_generate "'，def) ; g% 生成 CMEX S 函数 
legacYy_code( compile "，def) ; # 编译 CMEX S 函数 
legacYy_code(" sfcn tlc_generate "，def) ; 和 生成 TELC 文件 


2. $S 函数 与 TLC 文件 


以 下 是 S 函数 legacy_wrapsfcn.c 的 mdlOutputs 回调 方法 部 分 ,用 户 可 对 照 比较 4.1.1 
节 手 写 代 码 的 mdlOutpnuts 部 分 。 
static volid mdlOutputs(SimStruct xx S，int Ttid) 


real T # ul 


(real T *#* ) SsGetInputPortSignal(S，0); 

(real T #* ) ssGetOutputPortSignal(S，0); 
#*YL = doubleIt( #uUl); 

} 


LCT 工具 生成 的 TLC 文件 legacy_wrapsfcn. tlc, 与 手写 文件 相 比 ,同样 有 BlockType- 
Setup 与 Outputs 末 数 ,不 同 的 是 , 它 定 义 了 BlockInstanceSetup 与 BlockOutputSignal 函数 。 


real 了 T 关 Yl 


负 implements legacYy wrapsfcn "C"” 
币 第 Function:， BlockTYPpeSetup 
第 function BLockTYPeSetup(block，system) void 
种 和 The Target Language must be C 
$% if::GenCPP==1%s$ 定义 全 局 变量 
第 <LibReportFatalError("This S-Function generated by the Legacy Code Tool must be only used 
with the C Target Language ")> 
向 endif 
和 < LibahddToCommonIncludes(" doubleIt.h")> 
和 < LibhddToModelSources(" doubleIt )> 


g endfunction 


币 向 Function，BlockInstanceSetup 
第 function BlLlockInstanceSetup(block，system) void 
贡 < LibBlockSetIsExpressionComp1liant(block)> 

外 endfunction 
种 先 Function:， Outputs 
先 function Outputs(blLlock，system) Output 

gif !1DibBlockOutputSignalISExpr(O) 

% assign ul _val = LibBlockInputSignal(0，"”"，"”"，0) 
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% assign Y1_val = LibBlockOutputSignal(0，"”"，"”"，0) 
和 <YL_ val> = doubleIt( 多 < UL val >); 
先 endil 生 


种 endfunction 


先 币 Function: BlockOutputSignal 

第 function 
BlockOutputSignal(block,system,portIdx,ucv,lcv,idx,retTYyYpe) vold 
LibBlockInputSignal(0,，"” ",，""，0) 
LibBlockOoutputSignal(0，""，"”"，0) 


争 asSsign ul_val 


和 assign Y1 _Val 
秽 Switch retTYpe 
币 Case "Signal” 
名 if portIdx == 0 
第 return ”doubleIt( 多 < ul_val>)” 
汕 else 
外 assign errTxt = “Block output port index not supported: 
负 < portIdx >" 
币 < LibBlockReportError(block,errTxt)> 
币 endij 开 
第 defaul 
第 assign errTxt =“Unsupported return type: 和 < retTYype > 
币 < LibBlockReportError(block ,errTxt)> 
$ endswlitch 


先 endfunction 


3. 功能 验证 模型 
LCT 脚本 运行 后 ,系统 将 自动 建立 一 个 模型 ,其 中 包含 生成 的 S 顶 数 模块 (图 4. 1.7) 。 


double y1 = doublelt(fdouble uU1} 
legacy_WwWfrapsfcn 


图 4.1.7 生成 的 S 函数 模块 
在 该 模型 里 继续 添加 信和 号 源 .增益 .示波器 等 模块 (图 4.1.8)。 





Gain 


Scope 


图 4.1.8 功能 验证 模型 
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在 模型 参数 选项 里 选择 合适 的 求解 器 , 单 击 “ 仿 真 "按钮 ,得 到 与 图 4. 1. 5 所 示 一 致 的 仿真 
结果 。 如 图 4. 1. 9 所 示 ,S 函数 实现 了 设计 的 功能 。 


二 一 一 S 郴 数 结果 





图 4.1.9 输出 结果 


4.1.3 9%-Function Builder 


下 面 仍 然 以 doublelt. c 为 例 ,使 用 S-Function Builder 整合 doublelIt. c, 创 建 一 个 SFunc- 
tion Builder 模块 。 


为 了 对 比 S-Function Builder 创建 模块 的 功能 ,按照 图 4. 1. 10 新 建 一 个 包含 SFunction 
Builder 的 Simulink 模型 。Gain 模块 完成 乘 以 2 的 功能 ,验证 SFuntion Builder 能 和 否 实 现 
Gain 模块 相同 的 功能 ,Sine Wave 的 旺 值 设 为 1 。 


Sire Wave In1 times2 0 名利 . 
S-Function Bulilder 


Gain 






图 4.1.10 SFunction Builder 模型 
双击 打开 SFunction Builder 模块 , 作 以 下 设置 
(1) 在 Sfunction name 字段 中 输入 times2 。 
(2) 初始 化 界面 在 本 例 中 不 需要 更 改 。 
(3) 在 Data Properties 中 ,将 输入 /输出 定义 为 inl .outl ,如 图 4.1.11,、 图 4.1.12 所 示 。 


二 一 一 
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Port and Parameter properties 









Input ports | Output ports| parameters | Data type attributesj 


图 4.1.11 Input Ports 界面 


Port and Parameter Properties 





图 4.1.12 Output Ports 界面 


(4) 在 库 文件 界面 中 的 Library/Object/Source files 区 域 输入 doublelt. c, 在 Includes 区 


域 输入 井 include“doubleIt. h”, 如 图 4. 1. 13 所 示 。 


Include files and external function declarations 
Includes; 

include 《math.h》 

include “doubleIt.h” 


UbrarnwWCbject/Source files (one Per line) 
doubleIt.c 








External funcbhon dedarations: 
才 _ extern double func(double al) ; sr 





图 4.1.13 库 文件 界面 
(5) 在 输出 界面 中 输入 "outl = doublelt(” inl1) ,如 图 4.1. 14 所 示 。 


Code description 


Enter your C-code or call your algorithm.lf available, discrete and continuous states should be referenced as 
xDI0]..xDinl xcCl0]..xCln] respectively. Input ports, output ports and parameters should be referenced using 





symbols specified in the Daeta properties. These references sppear directy in the generated S-funchion. 


#out1l = doubleIt (*imnl) : 


”Inputs are needed in the output funcbon(direct feedthrough) | 





图 4.1.14 输出 界面 
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(6) 单 击 对 话 框 工 具 栏 的 Build 按钮 ,编译 信息 窗口 即 显示 完成 信息 ,如 图 4. 1. 15 所 示 。 


Compilation dagneostics 





的 圩 times2c created Success 仙 n| 


开 兴 imes2 wrapperc' created Success 人 uly 
笠 六 imes2ltlc created SUCCesSsfully 


笠 洒 S-functiontimes2.mexw32 Created SUCCeSS 人 ully 


图 4.1.15 编译 信息 


按 下 “仿真 ”按钮 ,示波器 显示 S 函数 输出 结果 与 增益 模块 的 一 致 ,说 明 S 函数 实现 了 设计 
的 功能 ,如 图 4. 1. 16 所 示 。 


吓 一 一 一 S 函 数 结果 


是 < 一 参照 结果 





图 4.1.16 仿真 结果 


4.1.4 三 种 方法 的 比较 


由 LCT 工具 生成 的 S 函数 与 SFunction Builder 生成 的 不 同 之 处 在 于 : 

(1) 由 SFunction Builder 生成 的 S 困 数 通过 wrapper 函数 的 builder wrapsfcn_ wrapper. 
c 调 用 doubleIt, c; 而 由 LCT 生成 的 S 郴 数 直 接 在 mdlOutputs 回调 方法 里 调用 doublelIt. c。 

(2) SFunction Builder 人 允许 用 户 在 Data Properties 面板 里 定义 S 困 数 的 输入 /输出 名 ; 
而 LCT 则 使 用 默认 的 u 和 y 作为 输入 /输出 名 ,用 户 无 法 更 改 。 

(3) SFunction Builder 与 LCT 默认 情况 下 ,都 使 用 继承 的 采样 时 间 , 但 SFunction 
Builder 的 偏 移 时 间 为 0.0,LCT 则 固定 为 次 仿真 步 长 。 

表 4.1.1 列 出 了 手写 S$ 函数 .代码 继承 工具 LCT 以 及 SFunction Builder 三 种 方法 之 间 
的 异同 。 
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数据 类 型 


数值 类 型 


帧 信号 


端口 维度 


S-function API 


代码 生成 支持 


Simulink 
Accelerator 模式 


模型 引用 


Simulink。AliasType ， 
Simulink，NurmericType 
Simulink。 StructType 
类 型 支持 


输入 /输出 总 线 信和 号 






表 4.1.1 三 种 生成 S$ 函数 方法 的 异同 
手写 C MEX S 函数 代码 继承 工具 LCT 


支持 所 有 内 建 的 数据 类 型 
支持 所 有 的 Simulink 如 果 要 使 用 定点 数据 ,必须 将 其 
数据 类 型 ,包括 定点 数据 | 指定 为 Simuiink. NumericType, 如 
果 用 户 未 指定 范围 , 则 不 能 使 用 


支持 实数 与 复数 信和 导 支持 内 建 数 据 类 型 的 复数 信号 
支持 帧 信号 与 非 帧 信号 不 支持 帧 信号 


支持 标量 、 一 维 、 多 维 支持 标量 .一 维 、 多 维 的 输入 / 输 
的 输入 /输出 信号 


出 信和 号 
支持 全 部 的 于 
function API 








支持 以 下 回调 方法 : 


mdlJnitializeSizes 









mdlInitializeSampleTimes 










mdlStart 





mdllnitializeConditions 





mdl(Outputs 


mdlTerminate 














支持 针对 骨 人 式 优化 的 代码 生 
成 ,同时 可 自动 地 生成 TLC 文件 。 
该 TLC 文件 支持 在 代码 生成 时 内 
炭 S 函数 的 表达 式 折 梧 







支持 代码 生成 ,如 果 在 
代码 生成 时 需要 内 艇 S 
盟 数 , 则 而 要 手写 TLC 
文件 













提供 了 在 Accelerator 
模式 下 使 用 TLC 或 
MEX 文件 的 选项 











提供 了 在 Accelerator 模式 下 使 
用 TLC 或 MEX 文件 的 选项 


使 用 引用 模型 时 ,提供 
了 继承 采样 时 间 选 项 与 
Normal 模式 支持 












使 用 引用 模型 时 ,使 用 默认 的 
行为 





支持 所 有 的 类 ,其 中 支持 的 类 有 
Simujlink. StructType 仅 Simulink,. AliasType 
用 于 S 郴 数 参数 Simulink. NumericType 


支持 输 人 /输出 总 线 信号 ,但 用 
户 需要 事先 在 MATLAB 工作 空 
间 定 义 Simulink. Bus 对 象 ,该 对 象 
必须 与 原始 C 代码 的 输 和 人 输出 结 
构 等 价 

不 支持 总 线 参 数 
















不 支持 输入 /和 输出 总 线 
信号 






第 4 章 ”设备 驱动 模块 的 编写 卫 





SFunction Builder 


支持 所 有 的 Simulink 数 
据 类 型 ,包括 定点 数据 


支持 实数 与 复数 信和 号 
支持 帧 信号 与 非 帧 信和 号 


支持 标量 .一 维 、 多 维 的 
输入 /输出 信和 号 


支持 以 下 回调 方法 : 
mdlInitialjizeSizes 
mdlInitializeSampleTimes 
mdijStart 

mdiDerivative 
mdiUpdate 

mdlOutput 


mdliTerminate 


支持 代码 生成 , 间 时 自 
动 地 生成 TLC 文件 ,用 于 
代码 生成 时 内 联 S 了 踪 数 


如 果 生 成 了 TLC 文件 ， 
则 在 Accelerator 模式 下 使 
用 该 文件 ,否则 使 用 MEX 
文件 


使 用 引用 模型 时 ,使 用 
默认 的 行为 


不 支持 这 些 类 


不 支持 输入 /输出 总 线 
信和 号 
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辆 : 基于 模型 的 设计 一 一 MCU 篇 


支持 可 调 参 数 与 实时 参数 


使 用 SS _DWORK_USED_AS_ 
DWORK 类 型 时 ,支持 DWork 工 
作 向 最 


续 表 4.1.1 
S-Function Builder 


支持 实时 参数 , 仅 在 仿 
真 时 支持 可 调 参数 
















手写 C MEX S 晒 数 


支持 可 调 参数 与 实时 
参数 





可 调 参数 与 实时 参数 
















支持 所 有 的 工作 向 量 
类 型 


工作 向 量 无 法 访问 工作 向 其 






表 4.1. 2 进一步 总 结 了 上 述 三 种 方法 的 主要 功能 限制 
表 4.1.2 三 种 生成 S 函数 方法 的 限制 


限 制 


(1) 不 支持 总 线 输 人/ 输出 信号 
于 号 C ME S 困 数 。 | (2) 不 支持 模型 引用 
(1) 支持 使 用 CC 十 十 编写 的 源 代 码 , 不 支持 MATLAB 与 Fortran 函数 
《2) 支持 C 十 十 函数 .但 不 支持 C 十 十 对 象 
(3) 不 支持 连续 及 离散 状态 仿真 
(4) 不 支持 现 有 C 代码 使 用 函数 指针 作为 输出 
(5) 直 馈 标志 位 始终 为 真 
代码 继承 工具 LCT (6) 仅 支 持 连 续 求 解 器 ,但 次 仿真 步 长 .采样 时 间 及 偏 移 时 间 是 固定 的 
(7) 仅 支 持 Simulink 内 建 数据 类 型 的 复数 
(8) 不 支持 工作 向 量 ( 除 了 通用 DWork 向 量 ) 
(9) 不 支持 是 信和 号 输入 /输出 
(10) 不 支持 基于 端口 的 采样 时 间 
(11) 不 支持 基于 多 模块 的 采样 时 间 


(1) 目标 S 函数 使 用 wrapper 下 数 来 实现 ,但 其 中 包含 多 余 的 开销 
(2) 不 支持 工作 向 量 
S-Function Builder (3) 不 支持 基于 端口 的 采样 时 间 
(4) 不 支持 多 采样 时 间 , 以 及 非 零 的 偏 移 时 间 
(5) 不 支持 多 输入 /输出 口 的 动态 信号 ,但 对 于 单 输入 /输出 口 的 情况 ,支持 动态 信和 号 


4.2 S 了 天数 


4.2.1 SS 函数 工作 机 制 


创建 S 函数 之 前 ,必须 要 了 解 它 的 运行 机 制 , 而 这 又 需要 事先 了 解 Simulink 模型 的 仿真 
过 程 。 
对 于 Simulink 模块 ,一般 包含 输入 变量 .状态 变量 及 输出 变量 ,其 中 输出 是 仿真 时 间 、 输 
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人 变量 .状态 变量 的 函数 。 如 图 4. 2. 1 所 示 。 


一 


图 4.2.1 输入 .状态 和 输出 关系 图 


其 数学 表达 式 概 括 如 下 : 

?一 yo(Ct 工 ,2) 输出 

Z 一 六 (itzya) 微分 

Zd+ 一 矿 ( 人 tooyZdz&) 离散 状态 更 新 
其 中 z 一 [ze,rzdj 


Simulink 模型 的 工作 流程 ,是 通过 回调 方法 实现 的 ,如 图 4. 2.2 所 示 。 在 仿真 的 各 个 阶 
段 ,Simulink 引擎 调用 不 同 的 方法 ,执行 各 项 任务 。 





计算 下 一 采样 点 的 时 间 
( 仅 适 用 于 变 采样 率 模块 ) 


计算 输出 









玫 










仿 更 新 离散 状态 
真 在 最 后 一 个 
循 仿真 步 长 清 零 
环 计算 微分 
积分 〈 次 仿真 步 长 ) 


计算 微分 
定位 过 零点 


图 4. 2.2 模型 工作 流程 





1. 初始 化 阶段 


在 第 一 次 仿真 循环 之 前 ,Simulink 引擎 初始 化 S 郴 数 : 

(1) 初始 化 结构 体 SimStruct, 它 包含 了 S-Function 的 所 有 信息 。 
(2) 设置 输入 /输出 端口 数 与 维度 。 

(3) 设置 模块 采样 时 间 个 数 。 

《4) 决定 模块 的 执行 次 序 并 分 配 存 储 空间 。 


2. 仿真 循环 阶段 


一 次 循环 可 称 为 一 个 仿真 步 长 ,在 每 一 仿真 步 长 内 ,系统 按照 初始 化 阶段 决定 的 次 序 依 次 
执行 各 模块 。 对 于 每 个 模块 ,系统 调用 各 种 函数 计算 当前 采样 时 间 的 模块 状态 .微分 值 以 及 模 
块 输出 , 它 又 可 以 分 为 以 下 儿 个 步骤 : 
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(1 ) 计算 下 一 个 采样 时 间 点 。 对 于 变 采 样 时 间 的 模块 ,Simulink 引擎 需 要 调用 该 方法 , 计 
算 下 一 个 采样 时 间 。 

(2) 计算 输出 。 在 主 仿 真 步 长 ,计算 所 有 模块 的 输出 值 。 

(3) 更 新 离散 状态 。 在 主 仿 真 步 长 ,更 新 所 有 的 离散 状态 。 

(4) 数值 积分 。 该 积分 循环 仅 用 于 包含 连续 状态 和 /或 非 采样 过 零点 的 模型 。 

如 果 S 函数 存在 连续 状态 ,Simulink 引擎 在 次 仿真 步 长 内 调用 微分 和 输出 两 个 回调 方 
法 。 如 果 S 函数 存在 非 采 样 过 零点 ,Simulink 引擎 在 次 仿真 步 长 内 调用 输出 和 过 零 检测 肯 
数 。 不 断 执 行 该 循环 ,可 以 得 到 状态 所 需要 的 精度 。 


4.2.2 C MEX S 函数 模板 
Mathworks 公司 提供 了 两 种 C MEX S 因数 模板 : 
简化 模板 :位 于 . ..\MATLABANR2010bN\simulinkNsrcN\sfuntmpl_basic. c。 
详细 模板 :位 于 . ..\MATLAB\NR2010b\simulinkN\srcN\sfuntmpl doc, c。 


用 户 还 可 以 在 Smulink 模块 浏览 器 的 Simulink 一 UserDefined Functions 一 Sfunction 
Examples->C file Sfunctions 子 模块 库 找 到 这 两 个 模板 ,如 图 4. 2. 3 所 示 。 


ContinUous Dats typPe 
re RN Te 9 
ZerfC_ Crossin 吕 Miscellanecus gp 
Builder 








日 asiC 忆 Detaiied 
仑 - 拓 E 闪 CC-MEX 
TermpPlate Template < 加 
简化 模板 详细 模板 


4.2.3 C MEXS 函数 模板 
在 4. 1 节 中 ,用 户 已 初步 认识 了 S 函数 ,本 小 节 以 分 块 的 形式 介绍 S$ 函数 的 组 成 ,为 保持 
模板 的 完整 性 ,在 代码 段 内 不 作 任何 中 文 说 明 , 因 此 将 这 些 代 码 段 组 合 起 来 ,就 是 一 个 完整 的 
简化 模板 。 


1. 文件 头 部 
1 关 


x sfuntmpl _ basic.c: Basic "C" template for a level 2 Sfunction. 
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# | See matlabroot/simulink/src/sfuntmpl doc.c for a more detailed template | 


# _ Copyright 1990-2002 The Mathorks，Inc-. 
# SRevision: 1.27.4.2 5 
关 1 


内 
# YoOu must Speclify the S_ FUNCTION_NAME as the name of Your S-function 
# 《ii.e- replace sfuntmpl _ basic with the name of Your S-function) . 
并/ 

# define S_FUNCTION_NAME sfuntmpl basic 

井 define S_FUNCTION_LEVFL 2 

闪 
# Need to include simstruc.h for the definition of the SimStruct and 
# its associated macro definitions， 
关 1 


# include "simstruc.h"” 


在 文件 头 部 ,可 以 定义 变量 ,加 入 需要 的 头 文件 。 

模板 给 出 了 必要 的 函数 名 与 函数 级 别 的 定义 方式 ,用 户 应 将 sfuntmpl_basic 替换 为 其 他 
合适 的 名 称 ,函数 级 别 2 一 般 不 作 更 改 。 

simstruc. h 是 必要 的 头 文件 , 它 定 义 了 一 个 数据 结构 体 SimStruct 以 及 大 量 的 宏 画 数 , 可 
供 后 期 调用 。 


2. 错误 处 理 


/ x#* Error handling 


# YOUu should use the following technique to report errors encountered 
关 Within an S-function: 

尖 SSSetErrorStatts(S，"Error encountered due to . . .9); 

关 returni 

x Note that the 2nd argument to ssSetErrorStatus must be persistent 

关 有 emOrY. 

# It Cannot be a local variable，For example the following will cause 


x+ Unpredictable errors : 


光 mdlOutputs() 
{ 
共 char msgL256]; {ILLEGAL: to fix use "static char msg[256]; 允 
兴 Sprintf(msg，Error due to 争 s"，string); 
外 SSSetErrorStatus(S,msg); 
外 Feturni; 


闪 } 
x# See matlabroot/simulink/src/sfuntmp1l _ doc.c for more details. 
关 / 
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在 模板 里 ,错误 处 理 以 注释 方式 表示 ,这 说 明 它 们 不 是 必需 的 ,但 并 不 表示 这 不 重要 。 

例如 ,在 S 函数 执行 之 前 ,加 入 回调 方法 mdlCheckParameters(SimStruct“S) ,可 以 检查 
输入 的 参数 是 否 有 效 ,避免 了 S 函数 使 用 无 效 的 参数 进行 计算 。 

宏 函 数 ssSetErrorStatus 的 第 二 个 参数 ,必须 永久 驻 留 在 内 存 , 而 不 能 是 某 个 郴 数 的 局 部 
变量 ,模板 给 出 了 该 函数 的 一 种 错误 使 用 ,用 户 应 当 避 免 。 


volid ssSetErrorStatus(SimStruct ”SS，const char T“mSg) 


该 函数 在 执行 过 程 中 ,不 会 产生 异常 状态 ,因此 若 用 户 需 要 进行 异常 处 理 , 则 建议 使 用 
mexErrMsgTxt 作为 替代 ,不 过 它 需 要 另外 建立 一 个 优 于 所 有 S 函数 调用 的 异常 处 理 机 制 ,这 
将 带 来 额外 的 开销 。 第 4. 4. 1 节 , 介 绍 了 错误 处 理 的 实际 应 用 。 

3. 回调 方法 mdlInitializeSizes 


1/x#* Sfunction methods x* / 


1/ x* Function: mdlInitializeSizes 


# RbStract: 

关 The sizes information is used by Simulink to determine the 
S-function block ' s characteristics (number of inputs， 

攻 outputs，states，etc. ) . 

关 1 


static void mdlInitializeSizes(SimStruct ”S) 

人 

/ x# See sfuntmp]l doc.c for more details on the macros below 关 / 
ssSetNumSFcnParams(S，0); / * Number of expected Parameters #/ 
if (ssGetNumSFcnParams(S) !1= ssGetSFcnParamsCount(S)) { 

/x# Return jif number of expected 1!1= number of actual parameterS #x / 

return 
}》 
ssSetNumContStates(S，0) ; 
ssSetNumDiscStates(S，0); 
if〈1ssSetNumInputPorts(S，1)) returni; 
ssSetInputPortWidth(S，0，1); 
ssSetInputPortRequiredContiguous(S，0 ，true) ; 
/# direct input signal accesSs 关 / 

/xx Set direct feedthrough flag (1 = Yes，0 = no) . 
# 及 port has direct feedthrough if the input is used in either 
# 七 he mdlOutputs or mclGetTime0OfNextVarHit functions. 
# _ See matlabroot/simulink/src/stfuntnmp1l directfeed. 七 xt， 
关 1/ 
ssSetInputPortDirectFeedThrough(S，0，1); 
if〔〈1ssSetNumOutputPorts(S，1)) return; 
SSsSetOutputPortWidth(S，0，1) ; 
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SsSSetNumSampleTimes(S，1); 
SSsSSetNumRWork(S，0); 
SSSetNumIWork(S，0); 
SSsSetNumPWork(S，0) ; 
SSSetNumModes(S，0) ; 
SSSetNumNonsampledZCs(S， 0); 





/ * Specify the sim state compliance to be same as a built-in block x* / 
ssSetSimStateCompliance(S，USE_DEFRAULT SIM_STRTE) ; 


SSSetOptions(S，0) ; 
} 


mdlInitializeSizes 是 必要 的 回调 方法 , 它 用 于 以 下 几 方 面 : 


(1) 设置 S 函数 的 参数 个 数 。 
(2) 设置 S 函数 的 状态 数量 。 


(3) 设置 输入 口 的 个 数 .维度 以 及 直 馈 标志 位 。 


(4) 设置 输出 口 的 个 数 .维度 。 
(5) 设置 采样 率 的 个 数 。 
(6) 设置 模块 工作 参数 的 大 小 。 
(7) 设置 模块 仿真 选项 。 


这 些 工 作 通常 由 宏 函 数 完 成 ,为 了 便于 理解 , 表 4. 2.1 列 出 了 代码 中 的 宏 函 数 意义 ,完整 


的 函数 使 用 方法 ,请 参考 文献 。 
表 4.2.1 


宏 函 数 
ssSetNumSFcnParams(S，0) 
ssGetNumSFcnParams(S) 
ssGetSFcnParamsCount(S) 
ssSetNurnContStates(S，0) 
ssSetNumDiscStates(S，0) 
ssSetNumJInputPorts(S，1) 
ssSetInputPortWidth(S,，0，1) 
ssSetJInputPortRequliredContiguous(S，0 ，true) 
ssSetlnputPortDirectFeedThrough(S,，0，1) 
ssSetNumOutputPorts(S，1) 
ssSetOutputPortWidth(S，0，1) 
ssSetNumsSarmpleTimes(S，1) 
ssSetNumRWork(S，0) 
ssSetNumJWork(S，0) 
ssSetNumPWeork(S，0) 


mdlInitializeSizes 宏 函 数 意 义 


意 义 
设置 S 函数 参数 的 个 数 为 0 
获取 S 函数 参数 的 个 数 
获取 封装 S 函数 时 ,对话 框 的 参数 个 数 
设置 S 下 数 的 连续 状态 数量 为 0 
设置 S 晒 数 的 离散 状态 数量 为 0 
设置 S 郴 数 的 输 和 人 口 数量 为 : 
设置 S 函数 第 0 号 输入 口 的 维度 为 1( 端 口 的 次 序 从 0 开始 编排 
设置 S 本 数 第 0 号 输 人 口 的 信号 保存 在 连续 的 内 存 空间 
设置 S 郴 数 第 0 号 输入 口 的 直 馈 状态 为 真 
设置 S 函数 的 输出 口 个 数 为 1 
设置 S 本 数 第 0 号 输出 口 的 宽度 为 1 
设置 S 函数 的 采样 时 间 个 数 为 1 
设置 S 函数 的 浮 点 工作 向 量 的 大 小 为 0 
设置 S 函数 的 整 型 工作 向 量 的 大 小 为 0 
设置 S 函数 的 指针 工作 向 量 的 大 小 为 0 
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续 表 4. 2.1 
宏 函 数 意义 
ssSetNumModes(S,， 0) 设置 S 函数 的 模式 向 量 的 大 小 为 0 
VssSetNumNonsampledZCs(S，0) 设置 S 函数 在 采样 点 之 间 检 测 过 零 状态 的 数量 为 0 


ssSetSimStateCompliance(S，USE_DEFAULT_SIM_ 
STATE) 


ssSetOptions(S，0) 设置 S 郴 数 的 选项 为 无 


设置 S 函 数 在 保存 及 恢复 模型 仿真 状态 时 的 行为 


4. 回调 方法 mdlInitializeSampleTimes 


/ * Function: mdlInitializeSampleTimes 


关 Rbstract， 

This function is used to specify the sample time(s) for Your 

其 S-function，You must register the Same number of sample times as 
共 specified in ssSetNumSampleTimes. 

% 1/ 


Static void mdlInitializeSampleTimes(SimStruct * S) 


人 
SSsSetSampleTime(S，0，CONTINUOUS_SRAMPLE_ TIME) ; 


ssSetOffsetTime(S，0，0.0); 
} 
mdlInitializeSampleTimes 也 是 必要 的 回调 方法 ,用 于 设置 采样 时 间 值 和 偏 移 量 , 采 样 时 
间 个 数 必 须 与 宏 函 数 ssSetNumSampleTimes 设置 的 一 致 。 
表 4.2.2 mdlinitializeSampleTimes 宏 函 数 意义 


宏 函 数 意义 
ssSetSampjleTime(S, 0，CONTINUOUS SAMPLE_ TIME) 设置 第 1 个 采样 时 间 的 周期 为 连续 采样 
ssSetOffsetTime(S，0，0. 0) 设置 第 1 个 采样 时 间 的 偏 移 量 


s。 回 调 方法 mdlInitializeConditions 


# define MDL_INITIRLIZE CONDITIONS 
/ x* Change to 井 undef to remove function </ 
# if defined(MDL_INITIRLIZE_ CONDITIONS) 


1 # Function， mdlInitializeCconditions 


# 及 DStIact : 

关 In this function，yYyou should initialize the continuous and 
关 discrete states for Your S-function block. 

关 The initial states are placed in the state vector， 

基 SSsGetContStates(S) or SSsGetRealDiscStates(S) . 

共 You can also perform anYy other initialization activVities 


关 that YOUr S-function may require. 
其 Note，this routine will be called at the 


.IT70 次 


第 4 章 设备 驱动 模块 的 编写 攻 


关 start of simulation and if it is present in an enabled subsystem 
关 configured to reset states，ijit will be cal1l when the enabjed 

其 subsystenm restarts execution to reset the States. 

其 / 


static void mdlLlInitializeConditions(SimStruct #* S) 
{ 


} 
井 endif / * MDL INITIRLIZE CONDITIONS * / 


mdlInitializeConditions 是 一 个 可 选 的 回调 方法 ,如 果 用 户 定 义 了 连续 或 离散 状态 , 则 必 
须 在 此 初始 化 这 些 状态 。 当 然 这 里 也 可 以 定义 其 他 的 初始 化 操作 。 
6. 回调 方法 mdlsStart 


# define MDL_STRRT / * Change to 井 undef to remove function # / 
井 if defined(MDL_ STRART) 
/ # Function: mdlStart 


# 及 bsStract: 

类 This function is called once at start of mode]l execution，If 
关 You have states that should be initialized once， 

其 this is the place to do 二 . 

关 1 


static void mdlStart(SimStruct # S) 
{ 


} 
井 endif / * MDL_STRRT */ 


mdlStart 也 是 一 个 可 选 的 回调 方法 。 用 于 在 仿真 开始 时 ,为 S 函 数 分 配 内 存 , 设 置 用 
户 数据 ,初始 化 状态 。 该 方法 只 执行 一 次 ,因此 如 果 S 函数 位 于 一 个 使 能 子 系统 内 ,而 用 
户 又 希望 在 每 次 子 系统 有 效 时 ,重新 初始 化 状态 , 则 需要 把 该 任务 定义 在 mdlInitialize 
Conditions 。 
7. 回调 方法 mdlOutputs 


/ x# Function: mdlOutputs 


# Rbstract: 

共 In this function，yYyou Compute the outputs of Your Sfunction 
藉 block. 

共 7 


static volid mdlOutputs(SimStruct #* S，int Ttid) 

. 
const real T *U = (const real T* ) ssGetInputPortSignal(S,0); 
real_T #* YY = SSGetOutputPortSignal(S,0); 
YLo] = uLo]j; 

}》 


mdlOutputs 是 一 个 必要 的 回调 方法 ,在 每 个 仿真 步 长 ,计算 当前 步 长 的 S 函数 输出 ,并 将 
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结果 保存 在 S 函数 输出 信号 数组 。 第 4.4. 1 节 , 介 绍 了 输出 回调 方法 的 实际 应 用 。 
表 4.2.3 一 组 常用 的 信号 访问 宏 函 数 


宏 函 数 意义 
ssGetInputPortRealSignal 获取 输入 连续 实数 信号 所 在 的 内 存 地 址 
ssGetInputPortRealSignalPtrs 获取 double 类 型 输入 信和 号 的 指针 
ssGetJInputPortSignal 获取 输 人 连续 信号 数据 所 在 的 内 存 地 址 
ssGetInputPortSignalPtrs 获取 除了 doubie 类 型 输入 信号 的 指针 
ssGetOutputPortRealSignal 获取 double 类 型 输出 信号 的 指针 
ssOGetOutputPortSignal 获取 输出 信号 向 量 的 指针 


8. 回调 方法 mdliUpdate 


# define MDL_ UPDRATE  / * Change to 井 undef to remove function #/ 
# if defined(MDL UPDRTE) 

1/ * Function: mdlUpdate 

# 员 bStract， 


关 This function is called once for everYy major integration 七 ime 
放 Step. Discrete States are typlically updated here， 

尖 but this functionis useful for performing any tasks 

类 that should only take Place once per integration step. 

关 / 

static volid md]lUpdate(SimStruct x* S，int Ttid) 

人 

} 


#endif / x* MDL UPDRTE x / 
mdlUpdate 是 一 个 可 选 的 回调 方法 ,在 每 个 主 仿真 步 长 ,计算 S 函数 的 当前 状态 ,将 结果 
保存 在 状态 向 量 ,同时 也 可 执行 其 他 需要 在 主 仿真 步 长 进行 的 操作 。 


9。 回调 方法 mdlDerivatives 
井 define MDL_ DERIVRTIVRES / * Change to 井 undef to remove function #x / 
#if defined(MDL_DERITVRATIVES) 
/* Function: mdlDerivatives 


# 只 bsStract 
In this function，You compute the S-function block 's 
兴 derivatives. The derivatives are Placed in the derivatlive 


关 Vector ，SsGetdX(S) . 

关 

static void mdlDerivatives(SimStruct ** S) 
{ 


} 
#endif / * MDL_ DERIVRTIVES x / 
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mdlDerivatives 是 一 个 可 选 的 回调 方法 ,在 每 个 仿真 步 长 ,计算 S 枉 数 中 连续 状态 的 微 
分 ,并 将 微分 值 保 存在 S 函数 状态 微分 数组 。 


10. 回调 方法 mdlTerminate 


/ #* Eunction: mdlTerminate 


# Abstract: 

关 In this function，You Should perform any actions that are 

兴 necessary at the ternmination of a Simulation， For example，i 
四 memory WaS allocated in md]lStart，this is the Place to free 示 ， 
闪 1 


static void mdlTerminate(SimStruct x* S) 
{ 
} 


mdlTerminate 是 最 后 一 个 必要 的 回调 方法 ,该 方法 执行 诸如 释放 在 mdlStart 方法 中 分 配 
的 内 存 等 ,必须 在 仿真 结束 时 或 S 函数 模块 被 删除 时 才能 执行 的 动作 。 

对 于 C MEX S-functions, 当 用 户 执 行 了 模型 更 新 (Update Diagram) 或 系统 遇 到 以 下 任何 
一 种 情况 时 ,调用 该 mdliTerminate 方法 。 

(1) 系统 调用 了 mdlStart 方法 ,但 S$ 郴 数 本 身 未 定义 任何 的 mdlInitializeConditions 方法 。 

(2) 系统 调用 了 mdlInitializeConditions 方法 。 


11. 文件 尾部 


/# Required SFfunction trailer # / 
井 ifdef MRTLRB MEX_FILE /x* Is this file being compiled as 日 MEX-Efile? 


井 include " simulink.c” /#x MEX-file interface mechanism #/ 

并 else 

井 include "cg_sfun.h” 1/ * Code generation registration function #* / 
井 endif 


这 些 尾 部 信息 是 必需 的 ,它们 作为 MEX 文件 与 Real-Time Workshop 的 接口 ,一 般 情况 
下 ,用 户 不 需 作 任何 修改 。 


4.2.3 其 他 回调 方法 


以 下 简要 介绍 其 余 27 个 可 选 回 调 方法 的 语法 及 意义 : 
1. 函数 名 :mdlCheckParameters 
语法 : 


## define MDL_CHECK_PARRMETERS 
void mdlLCheckParameters(SimStruct * 5S) 


意义 :检查 S 函数 参数 的 有 效 性 。 
2. 函数 名 :mdlDisable 
语法 : 
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并 defline MDL DISABLE 
voljld mdlDisable(SimStruct #* S) 


意义 :如 果 一 个 有 效 的 子 系统 在 当前 仿真 步 长 ,即将 由 使 能 状态 转换 为 禁止 状态 , 则 Sim- 
ulink 引擎 调用 该 方法 。 


3. 函数 名 :mdlEnable 
语法 : 
间 # define MDL_FENABLE 
void mcdlREnable(SimStruct # S) 


意义 :如 果 一 个 有 效 的 子 系统 在 当前 仿真 步 长 ,即将 由 禁止 状态 转换 为 使 能 状态 , 则 Sim- 
ulink 引擎 调用 该 方法 。 
4. 函数 名 :mdlGetSimState 
语法 : 
# define MDL_SIM_STRTE 
mxRrrayx mdlGetSimState(SinStructx S) 


意义 :该 方法 返回 当前 S 函数 的 仿真 状态 ,保存 为 MATLAB 数据 结构 体 。 
s. 函数 名 :mdlGetTimeOfNextVarHit 

语法 : 

井 define MDL_ GET_ TIME OF _NEXT _VRAR_HIT 

void mdlGetTimeOfNextVarHit(SimStruct x S) 


意义 :指定 下 一 个 仿真 时 间 。 

6. 函数 名 :mdliProcessParameters 
语法 ， 
# define MDL_PROCESS_PRRRAMETERS 


volid mdlProcessParameters(SimStruct #* S) 
意义 :处 理 S 函数 的 参数 。 
7. 函数 名 :mdlProjection 
语法 : 
井 define MDL PROJECTION 


void mdlProjection(SimStruct x S) 

意义 :调整 系统 状态 的 求解 器 方案 ,以 更 好 地 满足 时 不 变 求 解 关系 。 
8. 函数 名 :mdIRTVW 

语法 : 


浆 


第 4 章 设备 驱动 模块 的 编写 F 晶 


# define MDL_RTW 
volid mdlRTW(SimStruct # S) 


意义 :在 Real-Time Workshop 工具 生成 model. rtw 文件 时 ,调用 该 方法 。 
9. 函数 名 :mdlSetDefaultPortComplexSignals 
语法 : 


间 define MDL SET _ DEFAULT PORT COMPLEX _ SIGNRLS 
Volid mdlSetDefaultPortCompJlexSignals(SimStruct * S) 


意义 :如 果 系 统 无 法 正确 获得 模块 所 有 端口 的 数值 类 型 (实数 .复数 .继承 ) , 则 将 其 设置 为 
该 方法 定义 的 默认 类 型 。 如 果 模 块 对 应 的 S 函数 未 定义 该 方法 ,而 至 少 有 一 个 端口 的 数值 类 
型 是 复数 , 则 设置 其 他 未 知 端口 为 COMPLEX _ YES ,否则 设置 为 COMPLEX_NO。 


10. 函数 名 :mdlsetDefaultPortDataTypes 
语法 : 


# define MDL， SET_DEFRAULT_ PORT_DRATR_TYPES 
void mdlSetDefaultPortDataTypes(SimStruct * S) 


意义 :如 果 系 统 无 法 正确 获得 模块 所 有 端口 的 数据 类 型 , 则 将 其 设置 为 该 方法 定义 的 默认 
类 型 。 如 果 模 块 对 应 的 S 函数 亦 无 定义 该 方法 , 则 将 所 有 端口 设置 为 double 类 型 。 若 某 些 端 
口 已 有 定义 , 则 将 其 他 未 定义 的 端口 设置 为 已 定义 数据 类 型 中 最 大 的 一 种 。 


11， 函数 名 .mdlSetDefaultPortDimensionInfo 
语法 : 


# define MDL_SRT_ DEFAULT PORT _DIMENSION_INFO 
void mdl1SetDefaultPortDimensionInfo(SimStruct x* S) 


意义 :如 果 模 型 无 法 提供 足够 的 信息 ,以 建立 信号 维度 , 则 系统 根据 该 方法 定义 的 默认 信 
息 , 完 成 信号 维度 传递 。 
12.。 函数 名 :mdlsetInputPortComplexSignal 
语法 : 
# define MDL_SET_INPUT_PORT_COMPLEX_SIGNRL 
void mdlSetInputPortComplexSignal(SimStruct x* S，int_T port，CSignal_T csig) 


意义 :设置 输入 端口 的 数值 类 型 (实数 .复数 .继承 ) 。 
13. 函数 名 :mdlSetInputPortDataType 
语法 : 
# define MDL_SET_INPUT_PORT_DATA_TYPE 
void mdlSetInputPortDataTYpe(SimStruct x* S，int_T port，DTYpeId id) 
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意义 :设置 输入 端口 的 数据 类 型 。 
14. 函数 名 :mdlSetInputPortDimensionInfo 
语法 : 


# define MDL_ SET _INPUT_PORT _ DIMENSION_INFO 
void mdlSetInputPortDimensionInfo(SimStruct x*S，int_ T port，const DimsInfto T x* dimsInfo) 


意义 :设置 输入 端口 的 信号 维度 。 
1$， 函 数 名 :mdlSetInputPortDimensionsModeFcn 
语法 : 
void mdlSetInputPortDimensionsModeFcn(SimStruct * S，int_T portIdx，DimensionsMode_T dimsMode) 
意义 :设置 输入 端口 的 维度 模式 ,其 中 参数 portIdx 表示 端口 索引 号 。 
16. 函数 名 :mdlSetInputPortFrameData 
语法 : 


井 define MDL_ SET_INPUT PORT _FRAME_DRATR 
void mdlSetInputPortFrameData(SimStruct x* SS，jint T port，Frame T frameData) 


意义 :指定 输入 端口 是 否 能 接受 蚌 数 据 。 
17. 范 数 名 :mdlSetInputPortSampleTime 
语法 : 


# def ine MDL_SET _ INPUT_PORT SAMPLE_TIME 
void mdlSetInputPortSampleTime(SimStruct * S，int_T port，real_ T SampleTime，real _T offsetTime) 


意义 :设置 输入 端口 的 采样 时 间 为 继承 。 
18. 函数 名 :mdlSetInputPortWidth 
语法 : 
# define MDL_SET_INPUT_PORT_WIDTH 
void mdlSetInputPortWidth(SimStruct xx S，int_T port，int_T width) 


意义 :设置 输入 端口 的 宽度 。 
19. 函数 名 :mdlSetOutputPortComplexSignal 
语法 : 


井 define MDL SET OUTPUT PORT _COMPLEX_ SIGNRL 
void mdlSetOutputPortComplexSignal(SimStruct x* S，int_ T port，CSignal T csig) 


意义 :设置 输出 端口 的 数值 类 型 (实数 .复数 .继承 ) 。 
20. 函数 名 :mdlsetOutputPortDataType 
语法 ， 
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井 define MDL SET OUTPUT PORT _DRATA_TYPE 
void mdlSetOutputPortDataTYpe(SimStruct *S，int T port，DTYypeId id) 


意义 :设置 输出 端口 的 数据 类 型 。 
21。 函数 名 :mdlSetOutputPortDimensionInfo 
语法 : 


#define MDL SET OUTPUT PORT _DIMENSION_INFO 
Volid mdlSetOutputPortDimensionInfo(SimStruct x+* S，int_T port，const DimsInpfo T # dimsInfo) 


意义 :设置 输出 端口 的 信号 维度 。 
22. 函数 名 :mdlSetOutputPortSampleTime 
语法 : 


# define MDL_SET OUTPUT_PORT_SAMPLE TIME 
volid md]lSetOutputPortSampleTime(SimStruct x S，int T port，real _ T sampleTime，real T offsetTime) 


意义 :设置 输出 端口 的 采样 时 间 为 继承 。 
23. 函数 名 :mdlSetOutputPortWidth 
语法 : 
# define MDL_ SET_OUTPUT_PORT_WIDTH 
void mdlSetOutputPortWidth(SimStruct x* S，int_T port，int_T width) 


意义 :设置 输出 端口 的 宽度 。 
24.， 函数 名 :mdilsetSimsState 
语法 : 


井 define MDL_SIM_STRTE 
void mdlSetSimState(SimStruct x* S，const mxhrray# in) 


意义 :在 仿真 开始 时 ,设置 初始 仿真 状态 为 SmState。 
2S$。 函数 名 :mdlSetVWorkWidths 

语法 : 

井 define MDL_SET WORK_WIDTHS 

void md]1SetWorkWidths(SimStruct x* S) 


意义 :指定 工作 向 量 的 大 小 ,并 建立 运行 时 参数 。 
26. 函数 名 :mdlSsimStatusChange 
语法 : 


# define MDL_SIM_STRATUS_CHRANGE 
void md]lSimStatusChange(SimStruct #* S，ssSimStatusChangeTYpe simsStatusy) 


意义 :在 仿真 暂停 或 恢复 时 ,调用 该 回调 方法 。 


法 。T77，。 } 
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27. 范 数 名 :mdlZeroCrossings 
语法 : 
# define MDL_ZERO_CROSSINGS 


void md1lZeroCcrossings(SimStruct # S) 


意义 :如 果 用 户 需 要 进行 过 零 检 测 , 则 需要 定义 该 方法 与 工作 向 量 。 


4.2.4 宏 画 数 


以 下 选取 几 个 常用 的 宏 函 数 , 详 细 说 明 其 使 用 方法 。 
1. 输入 /输出 口 

多 数 情况 下 ,输入 /输出 口 的 宏 函 数 是 成 对 出 现 的 ,因此 这 里 仅 介绍 输入 口 。 

(1) 本 数 名 ssSetInputPortWidth 

语法 

int_T ssSetInputPortWidth(SimStruct x* S，int T port，int T width) 

作用 :设置 输入 /输出 口 的 宽度 ; 

参数 port :端口 序号 (从 0 开始 ) 。 

width :宽度 值 ,必须 是 非 0 的 正 整 数 ,或 者 是 "DYNAMICALLY_SIZED”, 如 果 设 为 

后 者 , 则 需要 另行 定义 mdlSetInputPortDimensionInfo 与 mdlSetDefaultPort- 
DimensionInfo 两 个 回调 方法 。 

应 用 :设置 第 二 个 输入 口 的 宽度 为 5, 则 

SSsSetInputPortWidth(S，1，5) 


(2) 上 数 名 ssSetInputPortMatrixDimensions 

语法 

int_T ssSetInputPortMatrixDimenslions(SimStruct * S，int T port，int Tam，int_ Tn) 

作用 :设置 输入 口 能 够 接受 矩阵 信和 号 。 

参数 port :端口 序号 (从 0 开始 ) 。 

my n: 和 矩阵 的 两 个 维度 ,如 果 其 中 某 一 维度 为 DYNAMICALLY_SIZED, 则 另 一 个 也 

必须 为 DYNAMICALLY _SIZED 或 1。 如 果 设 为 DYNAMICALLY_SIZED， 
则 需要 另行 定义 mdlSetInputPortDimensionInfo 与 mdlSetDefaultPortDimen- 
sionInfo 两 个 回调 方法 。 

应 用 :设置 第 一 个 输入 口 可 接受 128X128 的 矩阵 信号 。 


ssSetInputPortMatrixDimensions(S，0，128，128) 


2. 采样 时 间 
(1) 困 数 名 ssSetNumSampleTimes 
语法 
int_T ssSetNumSampleTimes(SimStruct x* S，int T nSampleTimes) 


本 到 
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作用 :设置 S 函数 采样 时 间 的 个 数 。 

参数 nSampleTimes :采样 时 间 个 数 , 若 设置 为 大 于 0 的 正 整 数 , 表 示 是 基于 模块 的 采样 ; 
若 设置 为 PORT_BASED _ SAMPLE _TIMES, 则 表示 是 基于 端口 的 

应 用 :设置 采样 时 间 个 数 为 2。 


SSSetNumSampleTimes(S，2) 


(2) 函数 名 ssSetSampleTime 
语法 
time T ssSSetSampleTime(SimStruct * S，int_ T st_index，time T period) 
作用 :设置 指定 的 采样 时 间 。 
参数 st_index: 采 样 时 间 的 序号 (从 0 开始 ); 
period :采样 时 间 的 周期 值 。 
应 用 :设置 第 2 个 采样 时 间 的 周期 为 0. 1。 


SSsSetSampLleTime(S，1，0.1) 


(3) 函数 名 ssSetOffsetTime 
语法 
time T SSsSetOffsetTime(SimStruct x*S，int T st_index，time T offset) 


作用 :设置 指定 采样 时 间 的 偏 移 量 ,在 此 之 前 ,必须 先 使 用 ssSetSampleTime 设置 具体 的 
采样 时 间 。 若 不 设置 , 则 系统 将 采样 时 间 设 为 连续 ,并 忽略 此 时 定义 的 偏 移 量 。 
参数 st_index: 采 样 时 间 的 序号 (从 0 开始 ) 。 
offset : 偏 移 量 的 数值 。 
应 用 :设置 第 2 个 采样 时 间 的 偏 移 量 为 0. 02。 


ssSetOoffsetTime(S，1，0.02) 


4.2.5 数据 访问 


一 个 S 函数 ,通常 含有 输入 信号 .输出 信号 .参数 .内 部 状态 ,以 及 数值 类 型 ,数据 类 型 、 指 
针 工 作 向 量 等 其 他 属性 。 

一 般 来 说 ,模块 的 输入 /输出 读 写 都 是 通过 模块 IO 向 量 进行 的 ,可 以 是 通过 根 输入 模块 
由 外 部 输入 或 通过 根 输出 模块 向 外 输出 ,并 且 接地 也 可 以 作为 输入 信和 号 。 

S 天 数 访问 输入 信号 的 方式 有 两 种 :指针 和 相 邻 输入 信号。 


1. 指 针 
为 了 便于 说 明 ,将 4. 1. 1 节 手 写 S 函数 的 输出 部 分 列 于 下 方 : 


static void mdl0Outputs(SimStruct *S，int tid)1{ 
InputRealPtrsType uPtrs = SSsGetInputPortRea1lSignalPtrs(S,0); 
real T #Y = 5sGetOutputPortRealSignal(S,0) ; 
#* 了 = doubleIt( * uPtrs[0]); 
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} 


代码 第 二 行 用 InputRealPtrsType 定义 了 一 个 特殊 的 指针 向 量 uPtrs, 宏 函数 ssGetInput- 
PortRealSignalPtrs 的 返回 值 是 指向 输入 信和 号 的 指针 数组 ,该 数组 的 每 个 元 素 事实 上 是 输入 信 
号 所 在 的 地 址 。 因 此 可 以 使 用 表达 式 * uPtrsLelementj ,访问 这 些 信 和 号。 

图 4. 2. 4 所 示 描 述 了 上 述 关 系 。 


uPtrs[] 数据 地 址 数据 
输入 信号 






0101010 






图 4.2.4 输入 信号 访问 方式 


当 S 盯 数 有 多 个 输入 口 时 ,宏明 数 ssGetInputPortRealSignalPtrs 针对 每 个 输入 信号 返回 
一 个 指针 数组 ,这 些 数组 所 指向 的 地 址 可 以 是 不 连续 的 ,图 4. 2. 5 所 示 为 基于 模型 的 设计 及 其 
嵌 人 式 实现 。 


UPtrs0 


UPtrsn 





图 4.2.5 访问 多 输入 端口 的 信号 


InputRealPtrsTYpe uPtrs0 = ssGetInputPortRealS:gnalPtrs(S,0); 
InputRealPtrsTYpe uPtrsl = SSsGetInputPortRealSignalPtrs(S,1); 


InputRealPtrsTYPe UPtrsn = ssGetInputPortRealSjgnalPtrs(S,m 一 1)， 


代码 第 三 行 定 义 了 输出 变量 指针 , 宏 郴 数 ssGetOutputPortSignal 返回 输出 口 的 向 量 , 此 
后 再 调用 外 部 函数 , 即 可 实现 源 函 数 的 功能 。 


real T #*yY = SSGetOutputPortRealSignal(S,0); 
#Y = doubleIt( x* uPtrs[ 0]); 


2. 相 邻 输入 信号 
在 回调 方法 mdlInitializeSizes 中 ,使 用 宏 函 数 ssSetIJnputPortRequiredContiguous 指定 输 
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人 信和 号 的 元 素 占 据 存储 器 中 的 相 邻 单元 。 如 果 输 入 已 经 是 相 邻 信号 , 则 用 回调 方法 ssGetIn- 
putPortSignal 访问 该 输入 信和 号 。 


以 下 是 两 种 访问 输入 信和 号 的 常见 错误 ,这 些 代码 虽然 可 以 编译 ,但 MEX 文件 会 与 Simu- 
link 冲突 ,因为 它 可 能 会 访问 无 效 的 内 存 空 间 。 

real T xu = #uptrsi /* 不 正确 */ 

尖 TV 十 十 二 并 + 十 1/x# 不 正确 */ 


4.2.6 目标 语言 编译 器 


1，TLC 概述 

Target Language Compiler(TLC) 是 Real-Time Workshop(RTW) 代 码 生 成 工具 的 一 个 
组 成 部 分 , 它 拥 有 类 似 于 HTML 的 标记 语法 ,类 似 于 Perl 等 其 他 脚本 语言 的 灵活 性 ,类 似 于 
MATLAB 强大 的 数据 处 理 能 力 (TLC 可 以 调用 MATLAB 函数 ) 。 

TLC 包含 两 组 TLC 文件 : 

(1) 模块 TLC 文件 : 它 与 Simulink 模块 库 中 的 基本 模块 一 一 对 应 ,用 于 生成 这 些 模块 的 
实时 代码 (不 包括 MATLAB function 模块 与 调用 了 MATLAB 文件 的 S 函数 模块 ), 用 户 也 
可 以 编写 自 定 义 设 备 驱 动 模块 的 TLC 文件 ,定制 其 能 人 式 C 代码 的 生成 过 程 。 

(2) 系统 TLC 文件 :用 于 指定 头 信息 与 参数 信息 ,例如 ert. tlc ,grt. tlc 等 。 

合理 地 编写 或 修改 TLC 文件 ,可 以 定制 生成 的 代码 ,例如 为 生成 的 代码 指定 硬件 平台 、 合 
并 现 有 的 算法 .修改 系统 目标 文件 指定 的 选项 .内 联 S 函数 .生成 附加 的 或 其 他 形式 的 文件 等 。 
这 种 开放 式 的 环境 为 用 户 提供 了 极 大 的 便利 ,但 用 户 不 应 该 修改 matlabroot / rtw /cytlc 目 
录 下 的 TLC 文件 ,这 会 导致 无 法 预测 的 结果 。 

Target Language Compiler 中 的 target 不 仅 表示 它 将 生成 高 级 语言 代码 ,还 表示 该 代码 
是 针对 某 一 实时 系统 的 。 这 也 就 说 明 由 TLC 生成 的 代码 已 充分 考虑 了 目标 处 理 器 的 功能 限 
制 , 并 尽 可 能 地 发 挥 其 处 理 能 力 。 

4.2.6 是 TLC 与 RTW 协同 工作 ,生成 可 执行 文件 的 过 程 。 
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图 4.2.6 可 执行 文件 生成 过 程 
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(1) RTW 读 取 模型 文件 model. mdl, 生 成 模型 描述 文件 model. rtw, 该 文件 以 ASCII 码 存 储 。 
(2) TLC 读 取 model. rtw, 并 根据 事先 选择 的 系统 TLC 与 模块 TLC 文件 ,生成 指定 目标 


的 代码 ,如 ANSIC /VC 十 十 代码 。 


(3) RTW 代码 生成 器 根据 给 定 的 模型 ,将 makefile 模板 生成 具体 的 makefile 文件 (mod- 


el. mk) ,该 文件 指定 了 用 于 生成 可 执行 文件 的 C/C 十 十 编译 器 及 编译 选项 。 


(4)》 连接 model. mk 与 运行 时 接口 支持 文件 ,将 代码 编译 生成 可 执行 文件 。 


2. inlined S 函数 的 TLC 文件 


S 函数 可 分 为 noninlined S 函数 与 inlined S 函数 ,前 者 只 用 于 仿真 ,不 需要 TLC 文件 ,后 
者 用 于 生成 实时 代码 ,需要 编写 TLC 文件 ,同时 还 删除 了 对 S 枉 数 自身 的 调用 以 及 
simstruc. h 中 一 些 不 必要 的 部 分 ,加 速 了 系统 的 仿真 以 及 降低 内 存 的 使 用 (simstruc. h 大 约 占 
用 1KB 的 内 存 )。inlined S 图 数 ,还 可 分 为 Fully inlined S 因数 与 Wrapper inlined S 函数 。 


这 两 种 S 函数 对 应 TLC 文件 的 写法 是 不 同 的 。 
以 下 是 这 两 种 S 函数 对 应 的 TLC 文件 的 示例 代码 


负 外 Fully inlined S-functions 
第 function Outputs(block，sVYystem) Output 
币 CY>=2.0x# 种 CU>; 


币 endfunction 


第 币 Wrapper inlined sfunctions 

和 function Outputs(block，system) Output 
先 CY> = doubleIt( $<u> ); 

$% endfunction 


由 此 可 以 看 出 ,wrapper ITLC 的 优势 在 于 : 

(1) S 苯 数 与 生成 代码 可 共享 现 有 C 代码 ,不 用 重 写 算法 。 

(2) 现 有 的 C 天 数 是 经 过 优化 的 程序 。 

(3) 采用 函数 调用 ,使 生成 的 代码 更 加 有 效 。 

(4) 可 以 将 已 有 的 C 代码 无 锋 地 合并 到 自动 生成 的 C 代码 中 。 
图 4. 2.7 显示 了 两 种 TLC 文件 生成 代码 的 区 别 。 


sfcn_inline.tic 

% function Outputs(block, system) Output 
9%<y> = 2.0*9%<u> ; 

9%endfunction 













在 TLC 文 件 中 
直接 编写 算法 





sfcn_inline.c 
mdlOutputs () 









model y =2.0 ”rmodel .ui; 
} 







生成 的 C 代 码 
包含 算法 


sfcn_wraptic 

% function Outputs (block, system) Output 
%<y> = doublelt( %<u> ); 

%endfunction 


在 TLC 文 件 中 
调用 算法 


mdliOutputs(0) 
{ 


model.y = doublelt (model .U); 
} 





生成 的 C 代 码 
包含 函数 调用 


图 4.2.7 两 种 代码 的 区 别 
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3. TELC 文件 结构 
这 里 仅 以 4. 1. 1 节 的 例子 说 明 TLC 文件 的 结构 ,代码 如 下 


负 jmplements legacYy wrapsftcn "C"” 
第 币 Function:， BlockTYpeSetup 
负 function BlockTYPeSetup(block，system) void 
有 负 The Target Language must be C 
% if ::GenCPP==1 外 肌 定义 全 局 变 其 
秽 < LibReportFatalError(" This S-Function generated by the Legacy Code Tool must be only used 
with the C Target Language ")> 
第 endif 
针 <LibaddToCcomnmonIncludes(" doubleIt.h")> 
多 < LibaddToModelSources(" doubleIt ”> 


多 endfunction 


多 先 Function: BlockInstanceSetup 
币 function BlockInstanceSetup(block，syYstem) void 
外 < LibBlockSetIsExpressionCompliant(block)> 
g% endfunction 
负 向 Function: Outputs 
负 function Outputs(block，system) Output 
名 if 1LibBlockOutputSignalIsSExpr(O0) 
$ assign ul_ val = LibBlockInputSignal(0，”"，"”"，0) 
$ assign yl1_val = LibBlockOutputSignal(0，""，"”"，0) 
针 < YL1_Vval> = doubleIt( 多 < ul val>); 
第 end 
$ endfunction 


第 先 Function: BlockOutputSignal 
$ function BlockOutputSignal(block,system,portIdx,ucv,lcv,idx,retTYype) void 
和 assigqn ul _ val = LibBlockInputSignal(0，” "，"”"”，0) 
凶 assign Y1_val = LibBlockOutputSignal(0，"”"，”"，0) 
负 Switch retTYPpe 
外 case " Signal " 
先 if portIdx == 0 
多 return " doubleIt( #%< ul _ val >)" 
币 elSe 
汕 assign errTxt = "Block output port index not supported:，g$ < portIdx > 
币 <LibBlockReportError(block,errTxt)> 
endif 
种 defaul] 七 
% assign errTxt = “Unsupported return type; 币 < retTYpe 六 
币 <LibBlockReportError(block,errTxt)> 
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蔬 endswitch 
第 endfunction 


TLC 文件 的 指令 以 非 空格 符 开 始 ,一 般 是 以 字符 “2%% ?开始 ,以 “% 吕 ?开始 的 为 单行 注释 。 
所 有 的 TLC 文件 表达 式 都 要 写 在 一 二 中 : 

(1) %implements: 是 所 有 模块 目标 文件 必需 的 ,是 模块 目标 文件 的 第 一 条 可 执行 指令 。 

(2) %function: 声 明 一 个 函数 。 例 如 ,%function Outputs(block ，system) Output ,表示 
定义 了 一 个 函数 名 为 Dutputs 的 函数 。 

(3) %% openfile、% closefile: 建立 一 个 文字 缓存 区 ,指令 之 间 的 文字 ,存放 在 变量 
buffer 中 。 

(4) block: 告 诉 TLC 是 在 模块 对 象 上 执行 的 操作 ,SFunction 的 TLC 代码 使 用 该 变量 。 

(5) %%assign 创建 或 修改 变量 ,U 指 所 有 的 模块 输入 , Y 指 所 有 的 模块 输出 。 

(6) 困 数 LibBlockInputSignal(portIdx，ucv，lcv，sigIdx) :返回 对 应 参考 模块 的 输入 


(7) 因数 LibBlockOutputSignal (portIdx，ucv，lcv，sigIdx) :返回 对 应 参考 模块 的 输出 
信和 号 。 

(8) portIdx: 端 口 索引 ,从 0 开始 编排 ,0 即 表 示 第 1 个 端口 。 

(9) ucv: 用 户 控制 变量 , 它 优 先 于 lcv 与 sigldx 这 两 个 参数 ,在 使 用 inlined S-function 时 ， 
该 参数 应 该 留 空 。 

(10) lcv: 循 环 控 制 变量 ,一般 设置 lcv 三 RollThreshold, RollThreshold 是 全 局 国 值 , 默 
认 值 为 5。sigIdx: 信 号 索引 ,有 些 时 候 也 可 以 认为 是 信号 元 素 的 索引 。 当 需要 直接 访问 输入 / 
输出 信号 的 某 一 特定 元 素 时 ,ucv 与 lcv 应 留 空 。sigldx 的 值 从 0 开始 编排 。 

(11) 若 某 条 指令 太 长 需要 另 起 一 行 时 ,可 以 用 C 语言 符号 ^\ ”或 MATLAB 中 用 到 的 
“…? 续 行 ,将 指令 分 成 多 行 。 例 如 

和 roll sigIdx = RollRegions，lcv = RollThreshold，block, 和 \\ 


”Roller "，rollVars 


或 者 
名 roll slgIdx = RollRegions，Jlcv = RollThreshold，block，. . . 


“Roller "，rollVars 


4.3 SS-Function Builder 


4.3.1 S-Function Builder 简介 


MathWorks 公司 为 了 简化 SFunction 模块 的 编写 ,提供 了 SFunction Builder 模块 ,用 户 只 
要 熟悉 其 面板 的 意义 , 按 要 求 一 步 步 做 下 去 就 能 快速 生成 用 户 算法 或 设备 驱动 模块 。 由 于 节 
Function Builder API 函数 只 是 SFunction API 的 一 个 子 集 , 所 以 应 用 受到 一 定 限 制 。 不 过 ,对 于 
不 太 熟 悉 $$Function 的 用 户 , 先 从 Function Builder 人 手 , 不 失 为 一 个 好 的 选择 。 
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SFunction Builder 模块 位 于 User-Defined Functions->SFunction Builder, 如 图 4. 3. 1 所 示 。 
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图 4.3.1 SFunction Builder 模块 
用 户 可 使 用 SFunction Builder 的 图 形 界面 设置 模块 的 参数 .TI/O 接口 .状态 等 ,并 自动 生 


成 一 个 SFunction ,完成 与 手写 S-Function 类 似 的 功能 。 
双击 SFunction Builder 模块 ,打开 S-Function Builder 对 话 框 ,如 图 4. 3. 2 所 示 。 








「 品 S-Function Builder test/S-Fumnction Builderl | 


Parameters 









S-functhion name; | 


S-funchon Parameters 


Name 





Initializaticn | Data properties] Libraries] Outputs] continuous Derivativesj Discrete Updatej| Build Info| 


| Pert/Pararmeter 
| Input Ports Description 
| 汉 The S$-Function Builder block creates a wrapper C-MEX S-funcicn from your supplied C code with multiple input 
了 可 Outpw Ports ports. output ports, and sa variable nurmber of scalar vector or matrix Pararmeters. The input and output ports 
风 0 can propagate Simulink buik-in data tyPes, fbed-point datatypes, complex frame, 1-D, and 2-D signals. This 
号 Parameters block also supports discrete and continuous state5 of type real, You can optionaliy have the blcck generate 5 


TLC 利 es to be used with Real-Time Workshop for code generation. 


S-funcbion sethings 
| Number of discrete stetes: 


Discrete state5 IC: 此 | 


Number of continuous states; 


| 

| 

Sample moede: | Inherited | 
| 


Continuocus stateg IC; 





图 4.3.2 S-Function Builder 对 话 框 


在 对 话 框 上 部 的 Sfunction name 区 域 输入 用 户 所 指定 的 SFunction 名 称 。Sfunction pa- 
rameters 区 域 列 出 了 该 SFunction 所 包含 的 参数 ,Name/Data type 的 设置 将 在 数据 属性 界面 中 
介绍 ,Value 栏 用 来 指定 对 应 参数 的 参数 值 ,用 户 可 以 根据 需要 在 此 输入 MATLAB 表达 式 。 设 
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置 完 毕 后 , 单 击 Builder 按钮 即 可 生成 生成 C 源 代 码 与 可 执行 的 MEX 文件 ,如 图 4. 3. 3 所 示 。 
以 下 分 节 说 明 对 话 框 下 部 的 各 选项 卡 功能 。 


Pararmeters 






S-function name; 
S-function Parameters 


Name Data typPe 


图 4.3.3 parameters 区 域 
4.3.2 初始 化 界面 (initialization ) 


初始 化 界面 $ 因数 的 设置 ,如 图 4. 3.4 所 示 。 


Initialization | Data properties| Libraries | Outputs| Continuous Derivatives Discrete Updatej Build Infoj 
Description 







The S-Function Builder block creates a wrapPer C-MEX S-function from your supplisd C code with multiple input 
ports, output ports, and a variable number of scalar vector or rmatrix Parameters. The input and output ports 
can propagate Simulink buit-in data types, foxced-Point datatyPes, complex, frarme, 1-D, and 2-D signals. This 
block also suppPorts discrete and continuous states of tyPe real. You can optionally have the block generate a 
TLC fle to be used with Real-Time Workshop for code generstion. 










S-function settings 
Number of discrete state5; 


Discrete states IC; 


Number of continuous states; 


Continuous states IC 


4.3.4 初始 化 界面 


(1) Number of discrete states/Number of continuous states:S-Function 中 离散 或 连续 状 
态 的 数量 。 

(2) Discrete states IC/VContinuous states IC:S-Function 中 离散 或 连续 状态 的 初始 状态 ， 
用 户 可 以 用 半角 逗号 分 隔 各 个 初始 值 ,如 0、1.2, 或 以 向 量 形式 表示 ,如 [0 1 2]。 初 始 值 的 个 
数 必须 与 先前 指定 离散 或 连续 状态 的 数量 一 致 。 

(3) Sample mode: 


@ Inherited:S-Function 模块 从 与 其 输入 端口 相连 的 前 级 模块 继承 采样 时 间 。 

@ Continuous :以 模型 的 仿真 步 长 作为 采样 时 间 。 

@ Discrete: 以 下 方 Sample time value 文本 框 指定 的 数值 作为 采样 时 间 。 

(4) Sample time value: 在 采样 模式 为 Discrete 时 有 效 , 采 样 时 间 只 能 是 标量 ， 

S-Function Builder 将 用 户 在 初始 化 界面 所 输入 的 信息 生成 mdlInitializeSizes 回调 方法 ， 
系统 在 模型 初始 化 期 间 调用 该 方法 ,用 以 得 到 该 SFunction 的 基本 信息 。 
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4.3.4 数据 属性 界面 (Data Properties) 


(1) 输入 /输出 接口 界面 (Input/output ports) ,如 图 4. 3. 5 所 示 。 


Port and Parameter properties 













Input ports | Output ports| Parameters | Data type attributes | 


3 [ ET 


图 4.3.5 输入 /输出 接口 界面 


Port and Parameter properties 区 域 的 左 侧 有 4 个 按钮 ,用 来 新 增 、 删除、 上 移 、 下 移 相 应 
的 端口 或 参数 。 
@ Port name: 指 定 端口 的 名 称 。 
@ Dimensions: 指 定 端口 信号 为 一 维 或 是 多 维 。 选 择 1-D 时 ,人 允许 动态 信号 维度 ,这样 用 
户 可 以 不 用 考虑 实际 的 信和 号 维度 。 
@ Rows: 指 定 信号 的 行 数 , 输 入 一 1 则 表示 动态 行 数 。 
@ Columns: 当 信号 维度 为 多 维 时 ,指定 信号 的 列 数 。 需 要 注意 :如 果 行 数 设置 为 动态 ， 
则 列 数 也 必须 设置 为 动态 或 1。 若 列 数 设置 为 其 他 数值 ,虽然 编译 可 以 通过 ,但 是 由 
于 这 个 不 正确 的 设置 ,任何 包含 该 SFunction 的 仿真 都 将 无 法 执行 。 
@ Complexity :指定 该 端口 支持 的 信号 是 实数 或 是 复数 。 
@ Frame: 指 定 该 端口 是 否 支 持 由 Signal Processing Blockset 或 Communications Block- 
set 生成 的 基于 帧 结构 的 信号。 
除了 Port and Parameter properties 区 域 的 选项 ,用 户 还 可 以 通过 左 侧 的 Port / Parame- 
ter 区 域 快速 定位 输入 /输出 接口 以 及 参数 。 
(2) 参数 界面 (Parameters) 如 图 4. 3.6 所 示 。 


Port and Parameter properbes 


z 寺 | 
其 














Input ports Output ports [parameters Data type attributes | 


2 






图 4.3.6 参数 界面 
中 Parameter name: 人 参数 的 名 称 。 
@ Data type: 指 定 参 数 的 数据 类 型 。 
@ Complexity: 指 定 参 数值 是 实数 或 是 复数 。 
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(3) 数据 类 型 属性 界面 (Data Type Attributes) 如 图 4. 3.7 所 示 。 


Port 3nd Parafmeter DrOPerties1 





| Input ports _ Output ports parameters Data tyPe attnibute5 









Po 比 Data type Word iength Signed Fraction length Slope Bia5 | 
关 瑟 0 double ~ 玫 和 2-3 























4.3.7 数据 类 型 属性 界面 


该 界面 列 出 了 SFunction 所 有 输入 /输出 端口 的 数据 类 型 属性 , 单 击 Data Type 栏 右 便 
的 下 拉 箭 头 , 修 改 端口 的 数据 类 型 。 


4.3.5 库 文 件 界 面 (Libraries) 


用 户 可 以 在 这 里 指定 外 部 代码 文件 的 名 称 与 位 置 ,外 部 代码 是 指 在 其 他 界面 输入 的 自 定 
义 代 码 中 引用 到 的 代码 文件 ,如 图 4. 3. 8 所 示 。 


| nttialization ， Data Propertles tibraries | Outputs continuous Derivatives Discrete Update | Build Info | 


Enmteranyjibranobjedt or 5ource file5 Uied bythe 3Sfuncdtion. Thenm, 5pecifyy any nece5jary include flle5 
Drsnterthe externalfunction decaration35, These functions cambe called inthe Output5 Derivative3s and 
Update method3， 


Indude fiies sd externa3l funecti 
IndudeS5 


Fincluade “math.hy》 


External function dedaration5 


中 EXtSTR double Fancfdouble sa): 





图 4.3.8 库 文 件 界面 
1. Library/Object/Source files 区 域 

该 区 域 用 以 声明 在 其 他 界面 输入 的 自 定义 代码 中 引用 到 的 外 部 库 文 件 . 对 象 代码 以 及 源 
文件 。 每 一 个 文件 单独 占 一 行 。 如 果 代 码 文件 处 在 当前 工作 目录 ,用 户 只 需 声 明文 件 名 即 可 ; 
如 果 代 码 文 件 处 在 其 他 的 目录 , 则 用 户 需 要 输入 完整 的 路 径 。 

另 一 种 方法 是 输入 用 于 搜索 库 文 件 ,对象 文件 . 头 文 件 以 及 源 文件 的 路 径 , 并 在 路 径 前 分 
别 加 上 标签 LIB_PATH INC_PATH SRC_PATH。 当 然 , 用 户 可 以 根据 需求 ,尽量 多 地 指定 
这 些 文件 人口 。 同 样 每 个 路 径 单 独占 用 一 行 。 

若 MATLAB 安装 于 C:\Program FilesS\MATLARBR\, 某 个 SFunction Builder 文件 处 于 
E:\user\, 需 要 链接 的 3 个 文件 位 于 以 下 位 置 

C:N\Program EilesNMRATLABN\user_object\dx. obj 

C:Nuser_ 1ibN\ku. 1ib 

D:N\sourceNyuan. c 
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对 应 的 代码 如 下 : 

LIB_ PATH S$S MRTLRBROOT\user _ object 
LIB_PRTH C:Nuser_1lib 

SRC_PATH  D:\source 

dx. obj 

ku. Tib 

Yuan.c 


从 上 例 可 以 看 到 ,路 径 标签 LIB_PATH 用 来 标志 对 象 文件 以 及 库 文件 路 径 ,SRC_PATH 
标志 源 文件 路 径 ,路 径 与 具体 文件 各 自 占用 一 行 。$MATLABROOT 表示 MATLAB 的 安装 
路 径 。 如 果 用 户 输入 了 多 个 LIB_PATH 路 径 , 则 系统 根据 路 径 的 上 下 次 序 , 依 次 搜索 。 

注意 :不 要 在 路 径 两 端 加 入 引号 ,即使 路 径 名 中 含有 空格 ,否则 编译 器 将 找 不 到 对 应 的 文件 。 

用 户 还 可 以 在 此 输入 预 处 理 指令 ,前 缀 一 D, 如 一 DDEBUG。 


2 Includes 区 域 


该 区 域 用 于 声明 头 文件 ,而 这 些 头 文件 又 声明 了 用 户 在 其 他 界面 输入 的 自 定 义 代 码 中 引 
用 到 的 函数 .变量 以 及 宏 定 义 。 每 个 头 文件 声明 占用 一 行 ,前 组 #include。 

对 于 标准 C 头 文件 ,需要 用 尖 括 弧 将 文件 名 括 起 来 ,例如 # include< 一 math. h> 。 

对 于 用 户 自 定 义 的 头 文件 , 则 需要 用 半角 双 引 号 ,例如 #include" xxx. h"。 

如 果 用 户 引用 的 头 文件 不 处 在 当前 工作 目录 , 则 需要 在 前 述 Library/Object/Source files 
区 域 ,前 缀 INC_PATH ,指定 该 头 文件 的 目录 。 


3，。External function declarations 区 域 


如 果 上 述 Includes 区 域 所 列 出 的 头 文件 对 一 些 外 部 函数 未 曾 声明 , 则 用 户 必 须 在 此 进行 
声明 ,每 一 个 函数 声明 占用 一 行 。S-FunctionBuilder 将 这 些 声明 包含 在 生成 的 SFunction 源 
文件 中 。 这 就 允许 SFunction 调用 这 些 外 部 本 数 ,计算 函数 状态 或 函数 输出 。 


4.3.6 输出 界面 (Outputs) 


输出 界面 ,如 图 4. 3. 9 所 示 。 


| Initialization ，Data Propertie5 Libraries， Outputs | Continuous Derivatives ;Discrete Update ，6uild Infoj 


“Code description 





Enter your C-code or call your algorithm,f available, discrete and continuUous state5 should be referenced 52. 


xD 的 .xDIn], xC[0].,.xCIn] rezpectively Input port5 output porty and parameteri hould be Pf 人 renced uing the 
25hibolz 3pecifed inthe Data Propemies, Theze referemcez appear directly in the genersted S-funcblon， 


村 This Sample sets tbhe oOtitpuot equal to the Inptt 
0fD] = 0 
For complex signals 56: Y0[0].re = 00[0j. re 
v0[ID0]. im = 0050]. ia 


ytLO0j.ra = lit0j.re 
FFO]. im = liL0]. ia: 刘 
己 ] Inputs are needed in the output functiontdiredtfeedthroughj 





图 4.3.9 输出 界面 有 
“189。 
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(1) 用 户 可 以 在 该 区 域 输入 自 定 义 的 C 代码 或 调用 某 种 算法 ,代码 或 算法 中 的 输入 /输出 
接口 或 参数 ,必须 使 用 在 前 述 “Data Properties 界面 >” 中 定义 的 符号 来 表示 。 系 统 将 在 每 个 采 
样 时 间 ( 仿 真 步 长 时 间或 离散 S-Function 的 采样 时 间 ) 计 算 SFunction 的 输出 值 。 

S-Function Builder 在 mdlOutputs 回调 方式 中 加 人 了 一 条 调用 这 个 wrapper 函数 的 代 
码 。Simulink 在 每 个 采样 时 间 调 用 mdlOutpnuts 方法 ,mdlOutputs 方法 又 调用 该 wrapper 顶 
数 , 这 时 才 真 正 执行 用 户 的 代码 ,并 将 结果 返回 SFunction, 作 为 输出 。 

mdlOutpnuts 方式 将 把 下 列 某 些 或 全 部 参数 传递 给 输出 wrapper 郴 数 。 

表 4.3.1 mdlOutputs 方式 传递 参数 


参 数 说 明 


SFunction 输 和 人 数组 的 指针 ,N 表示 在 JInput ports 页 面 中 定义 的 输入 端口 的 数量 

在 输出 wrapper 函数 中 出 现 的 参数 名 u0…… uN 就 是 在 Input ports 页 面 中 定义 的 输 人 端口 名 。 
每 个 数组 的 宽度 即 每 个 输入 端口 的 输入 宽度 。 如 果 先 前 指定 的 输入 宽度 为 一 1, 则 数组 的 宽度 将 
由 wrapper 函数 的 u_width 参数 决定 ( 详 见 表格 第 7 行 ) 


u0，ul，. .。 UN 


S-Function 输出 数组 的 指针 ,N 表示 在 Output ports 页 面 中 定义 的 输出 端口 的 数量 
在 输出 wrapper 琐 数 中 出 现 的 参数 名 Y0…yN 就 是 在 Output ports 页 面 中 定义 的 输出 端口 名 。 
y0，yl，..。yN 每 个 数组 的 宽度 即 每 个 输出 端口 的 输出 宽度 。 如 果 先 前 指定 的 输出 宽度 为 一 1, 则 数组 的 宽度 将 
由 wrapper 天 数 的 y_width 参数 决定 。( 详 见 表格 第 8 行 ) 
使 用 该 数组 向 Simulink 传递 由 用 户 代 码 计算 得 到 的 输出 


SFunction 离散 状态 的 数组 指针 。 仅 当 用 户 在 Initialization 页 面 中 定义 了 离散 状态 ,该 参数 才 有 效 
xD 第 一 步 仿 直 时 ,离散 状态 的 初始 值 由 用 户 在 Initialization 页 面 中 指定 。 在 接 下 来 的 采样 时 间 点 , 离 
散 状 态 值 来 自 SSFunction 在 上 一 次 采样 点 计算 得 到 的 数值 ( 详 见 下 文 “Discrete Update 界面 ”) 


S-Function 连续 状态 的 数组 指针 。 仅 当 用 户 在 Initialization 页 面 中 定义 了 连续 状态 ,该 参数 才 有 效 
xC 第 一 步 仿真 时 ,连续 状态 的 初始 值 由 用 户 在 Initialization 页 面 中 指定 。 在 接 下 来 的 采样 时 间 点 , 连 
续 状 态 值 来 自 对 上 一 次 采样 点 状态 导数 的 数值 积分 ( 详 见 下 文 “Continuous Derivatives 界面 >) 


param0，paraml ，. . . paramN 是 SFunction 参数 数组 的 指针 ,N 表示 在 Parameters 页 面 中 定 
param0，p_width0， 义 的 参数 数量 
paraml ，p_width1l ， p_width0 ，p_widthl,， ,. . .P_widthN 表示 人 参数 数组 的 宽度 。 如 果 某 个 人 参数 是 竺 阵 , 数 组 矩阵 行 
...paramN,p_widthN | 列 数 的 乘积 ( 即 矩 阵 元 者 的 个 数 ) 作 为 该 参数 的 宽度 。 例 如 一 个 3 行 2 列 矩阵 参数 的 宽度 为 6。 
仅 当 用 户 在 Data Properties 页 面 中 定义 了 参数 ,上 述 param0…… p_widthN 才 有 效 


SFunction 输入 数组 的 宽度 
u_width 仅 当 用 户 将 SSFunction 的 输入 宽度 设置 为 一 1, 该 参数 才 会 出 现在 生成 的 代码 中 。 如 果 输 入 是 
一 个 矩阵 ,u_width 则 等 于 和 矩阵 行列 数 的 乘积 ( 即 矩 阵 元 素 的 个 数 ) 


S-Function 输出 数组 的 宽度 
y_width 仅 当 用 户 将 SFunction 的 输出 宽度 设置 为 一 1, 该 参数 才 会 出 现在 生成 的 代码 中 。 如 果 输 出 是 
一 个 矩阵 ,y_width 则 等 于 矩阵 行列 数 的 二 积 ( 即 和 矩阵 元 素 的 个 数 ) 


人 @ Inputs are needed in the output function(direct feedthrough) 复 选 框 。 如 果 S-Func- 
tion 当前 的 输入 值 用 于 计算 其 输出 , 则 勾 选 该 复 选 框 。 

Simulink 将 通过 该 复 选 框 检 查 是 否 存 在 由 于 直接 或 间接 连接 SFunction 的 输入 /输出 端 
而 形成 的 代数 环 。 
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4.3.7 连续 状态 求 导 (Continuous Derivatives ) 


连续 状态 求 导 界面 如 图 4. 3. 10 所 示 。 


| Intialization Data properties | Librarie5 Outputs，Continuous Derivatives | Discrete Update | Build Info | 


ipfti 


站 SC 





This yection is ption3l 3nd Use to calculate the derivativez. 耻 13 Called oniy 和 the Sfunction haz one or more coptinuous* 
tate3, The statez 3nd derivatives of the Snmction are of type double snd muXtbe referenced 35XCIOL XCI etc and dx 
sand dx etc reypedctivwely. Jnput ports output ports and parameters hould be referemced Uying the 3mboli pecifed in the 
Data Propertie3, These referencez 3ppear directiy in the gemerated 5-fumcuon， 





图 4.3.10 连续 状态 求 导 界 面 


如 果 S-Function 中 含有 连续 状态 ,用户 可 以 在 这 里 输入 用 于 求 导 的 代码 。 连 续 状 态 以 及 
导数 的 数据 类 型 是 double, 同 时 必须 用 xCL0j…xC[Lnj 与 dxL0j…dxLnj 分 别 表示 。 代 码 中 的 
输入 /输出 接口 及 参数 ,必须 使 用 在 “Data Properties 界面 "中 定义 的 符号 来 表示 。 

生成 代码 时 ,S-Function Builder 将 用 户 代 码 捅 人 一 个 wrapper 果 数 ,形式 如 下 ,并 以 sfun 
作为 SFunction 名 : 


void sfun _ Derivatives_Wrapper( Constreal Tx u， 
Constreal T 关 Y， 

real 了 # dx， 

real_ 了 # XC， 


Constreal T  #* param0， / #* Optional #x/ 


int_T P_widtho ， /# optional x/ 
real_T 交 Daraml， / 关 optional x / 
int_T P_widthl ， /# Optional * / 
int T Y_Wwidth， /7/* optional #x/ 

int 了 U_width)  /* optional x/ 

{ 

RE /#user codex / 

} 


S-Function Builder 在 mdlDerivatives 回调 方法 中 加 入 了 一 条 调用 这 个 wrapper 天 数 的 
代码 。Simulink 在 每 个 采样 时 间 结 束 时 调用 mdlDerivatives 方法 ,获取 连续 状态 的 导数 ( 详 见 
帮助 文档 “How the Simulink Engine Interacts with C S-Functions”) 。Simulink 求解 器 对 导 
数 进行 数值 积分 ,以 确定 下 一 采样 时 间 的 连续 状态 初 值 。 在 接 下 来 的 这 个 采样 时 间 里 ,Simu- 
jink 将 更 新 过 的 状态 回 传 给 mdlOutpnuts 方法 。 

mdlDerivatives 回调 方法 将 如 下 参数 传递 给 导数 wrapper 困 数 : 


u Y\dx、 xc Y width、u_ width、param0、p_width0 、 paraml、p_widthl1…paramN、p_widthN。 
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读者 可 以 发 现 , 参 数 dx 是 一 个 新 的 参数 , 它 是 一 个 数组 指针 ,宽度 等 于 用 户 在 “Initializa- 
tion 界面 ?指定 的 连续 状态 的 数量 。 用 户 应 该 使 用 该 数组 来 返回 导数 值 。 

引入 这 些 参数 ,系统 计算 导数 就 如 同调 用 一 个 带 输入 /输出 与 可 选 参数 的 果 数 。 用 户 还 可 
以 调用 在 Libraries 界面 声明 了 的 外 部 郴 数 。 


4.3.8 离散 状态 更 新 (Discrete Update) 


离散 状态 更 新 界面 如 图 4. 3. 11 所 示 。 


| Initialization ，Data Properties ， libraries Outputs ， Continuous Derivatives | Discrete Update | Build Info 


Code descriPtioDn 





This Section is optional smd Useto update the 出 3Crete State5, 让 is called onlyifthe y-funcion haz Onme or more 
di5crete 计 ate5, The 计 ates Of the function are oftype double and most be referenced 37 xD[ xD[ 人 etc re5spectiwvely， 


Input ports output ports and parameters hould be referenced U5ing the ymbols 35pecified in the Data Propertie5, The5e 
Me 他 remcez 5ppear directiy in the gemerated S-fUnmction， 





4.3.11 离散 状态 更 新 界面 


如 果 S-Function 中 含有 离散 状态 ,用户 可 以 在 这 里 输入 用 于 更 新 离散 状态 值 的 代码 ,在 
当前 采样 时 间 内 计算 的 数值 将 用 于 下 一 采样 时 间 。 

离散 状态 的 数据 必须 用 xDL0]…xDLnj] 表 示 。 代 码 中 的 输入 /输出 接口 及 参数 ,必须 使 用 
在 “Data Properties 界面 ?中 定义 的 符号 来 表示 。 

生成 代码 时 ,S-Function Builder 将 用 户 代 码 搬 和 一 个 wrapper 困 数 ,形式 如 下 ,并 以 sfun 
作为 SFunction 名 ; 


volid sfun _ Update _wrapper( constreal T#x u， 
Constreal T  #Y， 
real 了 # XD， 


constreal T  # param0， / 兴 Optional # 7/ 


int_ 了 T P_wlidth0 ， / x# Optional #7/ 
real 了 T # Paraml， 1 X# Optional #/ 
int_T P_widthl， / 关 Optional x/ 
int 了 T Y_width， /x# Optional 关 7 
int_T U_width) /xx Optional 关 / 

人 

0 / #USser code 关 /1 


S-Function Builder 在 mdlUpdate 回调 方式 中 加 入 了 一 条 调用 这 个 wrapper 函数 的 代码 。 
Simulink 在 每 个 采样 时 间 结 束 时 调用 mdlUpdate 方法 ,获取 下 一 采样 时 间 的 离散 状态 值 ( 详 
见 帮 助 文档 “How the Simulink Engine Interacts with C SFunctions”) 。 在 接 下 来 的 这 个 采 
样 时 间 里 Simulink 将 更 新 过 的 状态 回 传 给 mdlOutputs 方法 。 


1 .192 。 





第 4 章 ， 设 备 驱动 模块 的 编写 _ 国 


mdlUpdates 回调 方法 将 u、y、xD、y_width、u_width、param0、p_ width0 、paraml、p _ 
width1…paramN,p_widthN 等 参数 传递 给 更 新 wrapper 因数 。 

用 户 应 使 用 变量 xD( 离 散 状 态 ) 来 返回 离散 状态 值 。 

引 人 这 些 参数 ,系统 计算 离散 状态 值 就 如 同调 用 一 个 带 输 入 /输出 与 可 选 参数 的 函数 。 用 
户 还 可 以 调用 在 Libraries 界面 声明 了 的 外 部 另 数 。 


4.3.9 编译 信息 (Build Info) 
编译 信息 界面 如 图 4. 3. 12 所 示 。 


| 了 In 市 alization | Data Properties | Librarie5 ， Outputs ， Continuous Derivative5 ，Discrete Update | 8uild Info | 


人 人 Di3Won 修 30nm0 计 








Clickthe desired optons below or click Built 小 Save 


Build optiaon 






- ] Show compile step5 YI Generate WrappPerTLC Enabie acce55 to SimStrudt 








Create 3 debuggable MEX- 人 ie Save code only Additionalmethods， 





图 4.3.12 编译 信息 界面 


(1) 用 户 可 以 在 此 界面 设置 一 些 用 于 生成 MEX 文件 的 选项 。 

GD Compilation diagnostics:S-Function Builder 在 生成 C 源 代 码 和 可 执行 文件 时 ,显示 有 
关 的 信息 。 

@ Show compile steps: 选 中 该 项 ,Compilation diagnostics 区 域 将 显示 编译 的 每 个 步骤 。 

G@) Create a debuggable MEX-file: 选 中 该 项 ,生成 的 MEX-file 中 将 包含 调试 信息 。 

由 Generate wrapper TLC: 选 中 该 项 ,将 生成 TLC 文件 。 如 果 用 户 不 打算 让 SFunction 
在 Accelerator 模式 下 运行 ,也 不 打算 将 它 用 在 生成 Real-Time Workshop 代码 的 模型 中 , 则 不 
需要 生成 TLC 文件 。 

@@ Save code only: 选 中 该 项 ,将 不 生成 MEX 文件 。 

人 @ Enable access to SimStruct: 选 中 该 项 ,允许 SFunctionBuilder 生成 的 wrapper 图 数 访 
问 SimStruct (S) 。 于 是 用 户 就 可 以 在 Outputs .Continuous Derivatives Discrete Updates 等 
界面 中 使 用 SimStruct 的 宏 定义 及 函数 。 

(2) Additional methods 界面 如 图 4. 3. 13 所 示 。 


遇 S-Function Bullder test/S-Function 国 站 3 汪 








|rSelect TLC functions to be generated: 


| 


矿 Terminate 





图 4.3.13 附加 方法 
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该 对 话 框 允许 用 户 选择 在 TLC 文件 中 增加 更 多 TLC 方法 。 
更 多 信息 详 见 Real-TimeWorkshop TLC(Target Language Compiler) 帮助 文档 中 的 
Block Target File Methods 部 分 。 


4.4 创建 设备 驱动 实例 


在 目前 的 系统 开发 过 程 中 ,ADC 模块 的 应 用 十 分 广泛 , 它 能 够 在 物理 世界 与 嵌入 式 研究 
之 间 拱 起 一 座 桥 粱 ,因此 本 节 以 ADC 模块 为 例 , 描 述 ADC S 函数 的 实现 过 程 。 

Inlined S-function 不 同 于 noninlined S-function ,前 者 可 直接 用 于 生成 实时 代码 ,为 此 , 除 
了 需要 编写 noninlined S-function 外 ,还 应 该 提供 相应 的 TLC 文件 和 硬件 初始 化 信息 。 

编写 Inlinined S-function( 内 联 S 函数 ) 的 步骤 如 下 : 

(1) 编写 noninlined C MEX S-function 代码 。 

注意 ,不 能 用 它 来 读 写 目 标 硬 件 的 存储 器 地 址 ,只 能 通过 TLC 文件 才能 实现 这 些 操 作 。 

(2) 编写 TLC 文件 ,用 来 定制 RTW ,为 系统 模型 生成 实时 C 代码 。 

《3) 硬件 的 初始 化 方式 。 


定义 设备 头 文件 (device. h) 。 该 文件 包含 有 指定 IO 硬件 的 宏 定义 ,变量 定义 .code 
库 等 内 容 。 

@ 通过 在 TLC 文件 的 start 方法 ,初始 化 硬件 的 工作 状态 。 

(4) 创建 ADC S 函数 模块 。 


4.4.1 HC12 模 数 转换 模块 


本 例 将 介绍 Freescale HC12 微 处 理 器 上 的 ADC 驱动 模块 的 创建 过 程 。 
1. 编写 nonlined S-function 
编写 noninline C MEX S-function 代码 , 即 ADC_examp. c 源 代 码 如 下 : 


划 defline S_ FUNCTION NAME AMDC_examp /*# SS 函数 名 为 ADC_examp:# / 
并 define S FUNCTION_LRVEL 2 1/x#* 2 级 S 郴 数 */ 
/xx 定义 错误 提示 信息 */ 
井 define ERR_INVRLID SET_ INPUT DTYPR CALL N\ 
"Invaljd cal1l to mdl1SetInputPortDataTYpe " 
并 define ERR_INVRLID_SET_OUTPUT_DTYPE_CRLLN\ 
" Invalid cal1l to melSetOutputPortDataType 
define ERR_TNVRLID DTYPRE ”Invalid input or output port data tvVpe" 


/xx 宏 定 义 ( 需 要 simstruct.h 头 文件 ) x* / 
## include " simstruc.h" 


间 define TRUE 是 
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井 define FARLSE 0 
#define N PRR 5 /# 定义 模 块 的 参数 个 数 * / 


1 
# CHRNNELRRRAY RARG  - DC 通道 矩阵 (0 一 7 间 的 一 个 或 多 个 值 ) ,同时 定义 了 信和 号 宽度 
#_ SRAMPLRTIME(S) 采样 时 间 
贡 RTDBANK(S) - Bank0 或 Bank 1. 每 个 bank 提供 8 通道 
* USE10BITS(S) - 如 果 USE10BITS_MRGC==1 时 , 使 用 10 位 apDc ,否则 使 用 8 位 apC 
# _ LEFTJUSTIFY(S) -~ 如果 LEFTJUSTIFY_aRGC==1，1l6bit 的 结果 采用 左 对 齐 方式 ,否则 使 用 右 对 
其 齐 ( 默 认 ) 
% 1 


enum { RARTDBRANK_ARGC = 0，CHRNNELARRRY ARGC，USE10BITS_ARGC，LEFTJUSTIFY ARGC，SRAMPLETIME RARGC ); 
# define RATDBRANK(S) (mxGetScalar(ssGetSFcnParam(S,AIDBANK_RARGC) ) ) 
# define CHANNELRRRRY AMRG(S) (SSsGetSFcnParam(S,CHRNNELRRRAY_RARGC)) 
# define USE10BITS(S) (mxGetScalar(ssGetSEcnParam(S,USE10BITS_ RARGC) )) 
井 define LEETUUSTIEFY(S) (mxGetScalar(SssGetSFcnParam(S,LEFTJUSTIEFY RARGC) ) ) 
井 define SAMPLETIME(S) (mozGetScalar(sSsSGetSFcnParam(S,SRAMPLETIME RARGC) ) ) 


/* 模型 初始 化 */ 


Static void mclInitializeSizes(SimStruct #*S) 

《 
const unsigned int + paramPtr = mxGetData( CHRNNELRARRRY ARG(S) ); 
int nChannels; 


/* 设置 并 检测 参数 个 数 * / 

SSSetNumSFcnParams(S，N PRR) ; 

if (ssGetNumSFcnParanms(S) != ssGetSFcnParamsCount(S)) return; 
SSSetSFcnParanmNotTunable(S，0); 

/# 设置 5 个 参数 皆 为 不 可 调 * / 
SSSetSFcnParamNotTunable(S，1); 
SSsSetSFcnParamNotTunable(S，2); 
ssSSetSFcnParamNotTunable(S，3) ; 
SSsSetSFcnParamNotTunable(S，4); 

nChannels = mxGetNumberOfElements( CHRANNELRARRRY RARG(S) ); 
/# 信号 输入 端口 宽度 设置 为 nChannels * / 

ifEf(〈 !ssSetNumInputPorts( S，1 ) ) returny; 

SSSetInputPort 风 idth( S，0，nChannels ); 

/* 信号 输出 端口 宽度 设置 为 Channels */ 

if ( !ssSetNumOutputPorts( S，1 ) ) return; 
SSSetOutputPortWidth( S，0，nCchannels ) ; 


/* 把 输入 /输出 接口 的 数据 类 型 与 用 户 可 选 的 8/10 位 解析 度 相 关联 */ 
if (USE10BITS(S)) 


{ 
/* 选择 10 位 时 输入 /输出 的 数据 类 型 定义 为 uint16 * / 
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ssSetInputPortDataType( S，0，SS_UINT16 ); 
ssSetOutputPortDataTYype( S，0，3SS_UINT16 ); 


mm 


else { 

/* 选择 8 位 时 输入 /输出 的 数据 类 型 定义 为 uint8x / 
ssSetInputPortDataTYpe( S，0，SS_UINT8 ) 
ssSetOutputPortDataTyYpe( S，0，SS_UINT8 ); 


SSsSetInputPortDirectFeedThrough( S，0，TRUE ); 
/# 采样 率 个 数 */ 
ssSetNumSampleTimes( S，1 ); 

/#x 选择 */ 
ssSetOptions(S，SS_OPTION_EXCEPTION_FREE _ CODE) ; 
}) /7* 结束 mdlInitializeSizes 方法 */ 





1/x#* 采样 时 间 初 始 化 */ 
static void md]InitializeSampleTimes(SimStruct #*S) 
{ 

ssSetSampleTime( S，0，SAMPLETIME(S) ) ; 

) 7/Y* 结束 ndlInitializeSampleTimes 方法 x / 





/* 模型 输出 x / 
statjic void mdl0utputs(SimStruct #*S，int Ttid) 
{ 
1* 使 用 特殊 类 型 指针 “uPtrs”( 本 质 是 一 个 指针 向 量 ) 指 向 0 号 和 1 号 输入 端口 * / 
DTYpeId Y0DataTYyYpe; / x* SS_UINT8 或 SS_UINT16 */ 
int T Y0Width = ssGetOutputPortWidth(S，0); 
InputPtrsTYpe u0Ptrs = ssGetInputPortSignalPtrs(S,0); 
/* 得 到 输出 端口 数据 类 型 ID, 并 与 输入 信和 号 相 匹 配 * / 
VODataType = ssGetOutputPortDataTYPe(S，0) ; 
/* 将 输入 信号 赋 给 输出 端口 * / 
Switch (Y0DataType) 
{ 
/* 数据 为 uint8 型 时 的 输出 * / 
case SS_UINTS8 : 
{ 
uint8 T x* pPY0 = (uint8_T x )ssGetOutputPortSignal(S,0)# 
InputUInt8PtrsTYPe pU0 = (JInButUInt8PtrsTYPe)u0PtrSs3 
int is 
/:* 把 输入 信号 赋 给 输出 端口 * / 
for(i = 0; i<yoWidth; + + iD 
pYo[i] = *pU0OLi]; 
/#* 采 用 默认 的 碳 对 齐 方式 * 7/ 
} 
break; 





} 
/x# 数据 为 uint16 型 时 的 输出 * / 
case SS_UINT16 : 
人 
uint1l6 T x* pY0 = (uint16 T * )SSGetOutputPortSignal(S,0); 
InputUInt16PtrsType pU0 = (InputUInt16PtrsTYpe)u0Ptrs; 

int 1; 

for( 1 工 = 0; < YOWidth; 

/#* 把 输入 信号 赋 给 输出 端口 * ， 

if 《LEFTUJUSTIEY(S) ) ! 

/#* 若 采 用 左 对 齐 方式 , 需 左 移 6 位 .*/ 

pY0Li] = *pUo[i]<<6; 

) else { 
/*# 若 采用 右 对 齐 方 式 , 不 需 移 位 .* / 
pYOLi] = #*pU0Lij; 


} 
breajk; 
} 
上 /7/* end switch (Y0DataType) x / 
} /* 结束 mdl0utputs 方法 */ 


/ ， 该 方法 执行 诸如 释放 内 存 等 ,只 有 在 仿真 结束 时 或 s 函数 模块 被 删除 时 执行 、， 


static void mdlTerminate(SimStruct 关 S) 


{ 
》7x#* end mdlTerminate * / 


井 define MDL_STRART / x* 井 define MDL STRRT 后 , 才 可 调用 mdlStart 方法 */ 
井 if defined(MDL STARRT) 
Static void md]lStart(SimStruct * S) 
{ 
/#* 此 方法 只 在 仿真 过 程 中 输出 一 条 信息 * / 
让 (ssGetSimMode(S) == SS_SIMMODE_NORMRL) 1 

mexPrintf("\n ADC_examp driver: Simulating initializationNn ); 

} 
} 7 * 结束 mdlStart 方法 <*/ 
间 endif / x* MDL START * / 





/ * 判断 是 否 为 可 接受 的 数据 类 型 * / 


static boolean_ T isacceptableDataTVype(DTYPpeId dataType) 


{ 
boolean_T isahcceptable = (dataTYype == SS_UINT8 | | 
dataTYpe == SS_UINT16) ; 


return 1SAcceptable; 
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# define MDL_ SET INPUT PORT DRTR_TYPE 
/#* 设置 输入 端口 数据 类 型 Function: mdlSetInputPortDataTYpe 


二 二 二 二 二 二 二 二 二 二 一 二 一 一 二 二 二 二 二 二 二 二 二 二 二 二 二 二 二 


共 此 方法 用 来 动态 设置 端口 的 备 选 数据 类 型 。 若 选择 的 数据 类 型 可 接受 , 则 调用 
ssSetInputPortDataType 方法 设置 其 类 型 ;否则 调用 ssSetErrorStatus 
类/ 
Static void mdlSetInputPortDataTYpe(SimStruct * S， 
Int Port， 


DTYypeId dataType) 


if (port==0 ) { 
/#* 基 断 是 否 接受 该 数据 类 型 * / 
if( isahcceptableDataTYpe( dataTYpe ) ) { 
/#* 把 所 有 数据 端口 设置 为 该 数据 类 型 * / 
SSSetInputPortDataType( S，0，dataType ) ; 
ssSetOutputPortDataType( S，0 ，dataType ) ; 
else !{ 
/* 拒绝 该 数据 类 型 * / 
SSSetErrorStatus(Sv,ERR_INVALID DTYPE) ; 
Goto EXIT_POINT， 
} 
}) else { 


/*# 只 有 在 已 存在 的 输入 端口 数据 类 型 未 知 时 调用 该 方法 * / 


SSSetErrorStatus(S，ERR_INVRLID SET INPUT DTYPE CRTLTI) ; 
goto EXIT POINT; 
} 
EXIT_POINT; 
returni 
》 /7 * mdlSetInputPortDataType < / 


# defjine MDL SET OUTPUT PORT _DRATR_TYPE 
/#* 设置 输出 端口 数据 类 型 
# 此 方法 用 来 动态 设置 端口 的 备 选 数据 类 型 。 若 选择 的 数据 类 型 可 接受 , 则 调用 
ssSetOutputPortDataType 方法 设置 其 类 型 ;否则 调用 ssSetErrorStatus 
x / 
static void mdlSetOutputPortDataTYpe(SimStruct * S， 
Tt Port， 
DTYpeId ”dataTVype) 


1 《DO 0 


全 985 ae 
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/+# 判断 是 否 接受 该 数据 类 型 * / 
if( isacceptableDataTYype( dataType ) ) { 
/#* 把 所 有 数据 端口 设置 为 该 数据 类 型 * / 
ssSetInputPortDataTYpe( S，0，dataType ); 
ssSetOutputPortDataTYpe( S，0 ，dataTYype ); 
) else { 
/ * 拒绝 该 数据 类 型 * / 
SSSetRrrorStatus(S,ERR_ INVALID DTYPE); 
goto EXIT_POINT; 
} 
} else { 
/x* 只 有 在 已 存在 的 输出 端口 数据 类 型 未 知 时 调用 该 方 * / 
ssSetErrorStatus(S，ERR_INVALID_ SET_ OUTPUT DTYPE_CRLL) ; 
goto EXIT_POINT; 
} 
EXIT_POINT: 
Freturn; 


} / x* mdlSetOutputPortDataType * / 


# define MDL_SET_DEFAULT_PORT_DATRA_TYPES 
/* 设置 默认 端口 类 型 


* 当 备 选 数据 类 型 缺 省 时 ,调用 该 方法 为 动态 类 型 端口 设置 数据 类 型 

其 1 

static void mdlSetDefaultPortDataTypes(SimStruct #x S) 

{ 
/* 将 输入 端口 数据 类 型 设置 为 uint8 * / 
SSSetInputPortDataTYpe( S，0，SS_UINT8 ); 
SSSetOutputPortDataTYpe( S，0，SS_UINT8 ) ; 

} /7/* mdlSetDefaultPortDataTYypes * / 


井 define MDL_RIW 
static void mdlRTW(SimStruct #* S) 
人 
uint8 了 atdbank = (uint8_T) RATDBRNK(S) ; 
uint16 T xx channels = (ulint16 T * ) mxGetData(CHRNNELRRRRY RARG(S)); 
ulint8_T usel0BitRes = (uint8_T) USE10BITS(S) ; 
uint8_T leftjustify = (uint8_T) LEFTJUSTIFY(S) ; 


/* 向 模块 写 人 参数 * / 
if (1ssWriteRTWParamSettings(S，4,SSWRITE_VRALUE_DTYPE NUM,”RTDBank ，， 
&atdbank,DTINFO(SS_UINT8 ，COMPLEX NO) ， 


SSWRITE_VRLUE_DTYPE_VECT,"Channel1s",channels， 


枉 - - 05 : 


酉 : 基于 模型 的 设计 一 一 MCU 篇 


mxGetNumberOfElementSs(CHANNELRRRRY RMRG(S) )， 
DTINEO(SS_UINT16 ，COMPLEX_NO) ， 


SSWRITE_VRLUE_DTYPE_NUM," Usel0BitRes "， 
&usel0BitRes ,DTINEFO(SS_UINT8 ，COMPLEX_NO) ， 


SSWRITE_VRALUE_DTYPE_NUM," LeftJustify"， 
&leftjustify,DTINEFO(SS_UINT8 ，COMPLEX NO))) { 
returni / x* Simulink 将 会 报告 一 个 错误 * / 


1 其” 三 三 二 三 三 三 三 三 三 二 三 二 三 二 三 二 二 二 二 一 一 一 一 一 二 三 二 三 三 三 三 三 三 三 三 三 三 三 三 三 三 三 三 三 三 三 其 
* 确保 在 无 TLC 文件 时 不 能 由 RTW 生成 代码 
其 ”三 三 三 二 三 三 二 二 二 二 三 三 二 三 二 二 二 三 三 二 二 二 二 二 三 二 二 二 二 一 一 一 二 二 二 二 一 一 二 二 一 一 一 一 二 二 区 1 
# ifdef MRTLAB MEX FILE /* 该 文件 是 否 编 译 为 MEX-file xy/ 
# include "simulink.c” /# MEX-file 接口 机 制 * 7 
#else /* 确保 在 无 TLC 文件 时 不 会 被 RIW 使 用 * / 
井 error "Rttempted use norrinlined Sfunction KRDC_examp.c” 
并 endi 开 


1/ x# [EOF] AMDC_ examp.c */ 


(1) mdlInitializeSizes 回调 方法 :设置 S 函数 的 状态 数量 ,参数 个 数 ,输入 口 的 个 数 .维度 
以 及 直 馈 标志 位 ,出 口 的 个 数 .维度 ,采样 率 的 个 数 ,模块 工作 参数 的 大 小 和 模块 仿真 选项 。 

@ ssSetNumSFcnParams(S，N_PAR) 设 置 参 数 个 数 为 5。 

@ ssSetInputPortWidth(S，0，nChannels ) 设 置 输入 口 宽 度 为 nchannels。 

G@) ssSetOutputPortWidth(CS，0，nChannels ) 设置 输出 口 宽 度 为 nchannels 。 

由 ssSetInputPortDataType(S,，0，* ) 设 置 输入 口 数 据 类 型 为 uint8 或 uint16 。 

G@ ssSetOutputPortDataType(S,，0, * ) 设置 输出 口 数据 类 型 为 uint8 或 uint16 。 

图 ssSetInputPortDirectFeedThrough( S, 0，TRUE ) 设 置 直 馈 标 志 位 为 真 。 

@ ssSetNumSampleTimes( S,，1 ) 设 置 采 样 率 个 数 为 1。 

(2) mdlInitializeSampleTimes 回调 方法 :设置 采样 率 、 采 样 时 间 值 和 偏 移 量 。 

ssSetSampleTime(S,0,SAMPLETIME(S)) 设 置 采样 时 间 为 SAMPLETIME(S) 。 

(3) mdlOutputs 回调 方法 :在 每 个 仿真 步 长 ,计算 当前 步 长 的 S 函数 输出 ,并 将 结果 保存 
在 S 函数 输出 信和 号 数组 。 

InputPtrsType u0Ptrs 一 ssGetInputPortSignalPtrs(S,0) 定 义 了 特殊 类 型 指针 uPtrs 指 
向 输入 端口 。 

(4) mdlTerminate 回调 方法 :执行 诸如 释放 内 存 等 工作 ,但 必须 在 仿真 结束 时 或 $ 函数 
模块 被 删除 时 才能 执行 的 动作 。 本 例 中 该 回调 函数 为 空 。 

除了 上 述 S-Function API 外 ,本 代码 文件 还 用 到 了 如 下 可 选 SFunction APL， :mdlSstart， 
isAcceptableDataType，mdlSetInputPortDataType，mdlSetOutputPortDataType，mdlRTW ， 
mdlSetDefaultPortDataTypes。 


-00 人 
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其 中 mdIRTW 能 够 在 代码 生成 过 程 中 评估 并 将 数据 类 型 规范 化 ,在 RTW 工具 生成 
model. rtw 文件 时 ,调用 该 方法 ;mdlstart 在 SFunction 中 只 会 被 调用 一 次 ,其 功能 为 初始 化 
S 函数 的 工作 回 量 、 分 配 存 储 器 地 址 .设置 用 户 数 据 初始化 状态 等 ,并 且 只 有 用 # define 定义 
了 MDL _ START 后 ,mdlstart 才 会 被 调用 。 


2. 编写 TLC 文件 


和 implements ADC_examp "Cn" 
贡 多 Eunction: Start 


-二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


币 多 RDC 初始 化 代码 

第 第 

汕 function Start(block， SYStem) Outptut 

/xx S-Function "ADC examp "initialization Block:，%5<Namne>x*/ 

负 有 设置 MTD Bank0 或 Bank1l 

g% assign atdBank = CAST(“”“Number ",SEFcnParamSettings. ATDBank) 

/ * RTDxCTL2 register bits:, (查看 HC12 数据 手册 ) 

* ”该 寄存 器 用 来 设置 ADCc 的 使 能 位 。 例 如 :Bit?7 是 apc 上 电位 ,为 1 时 使 能 。Bitl 是 中 断 
x* “使 能 位 ,为 1 时 使 能 。Bit 0 是 中 断 标志 位 。 

* 更 详细 功能 介绍 可 查看 HC12 数据 手册 。 

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 B 让 0 
ADPU 

有 FFC 

下 多 下 工 

ETRIGLR 

ETRGP 

ETRGE 

RSCIE 

RSCIEF 


#+ 本 例 中 该 寄存 器 的 值 设 置 如 下 : 

# RDPU 1 打开 该 模块 

# REFC 0 在 访问 结果 寄存 器 之 前 读 取 状态 寄存 器 1(RMTDSTRT1) ,可 以 正常 清除 相应 CCF 标志 位 
# 及 WAI 0 等 待 模 式 ,aM/D 转换 继续 进行 
* ETRIGLE ”0 外 部 触发 电 平 / 边 沿 控制 位 
x ETRGP 0 外 部 触发 极 性 控制 位 

x ”了 TRGE 0 关闭 外 部 触发 

x# RSCIE 0 转换 序列 完成 中 断 使 能 位 

x RSCIE 0《( 只 读 位 ) 

+ 转换 为 十 六 进 制 表示 为 0x80 

交 “Example: TDOCTL2 = 0x80; 

兴 1/ 

$% 设置 ATDxCTL2 寄存 器 的 值 


有 


国 注 基于 模型 的 设计 一 一 MCU 篇 


RTD 秽 < atdBank > CTL2 = 0x80; 


/ # RATDOCTL3 register bits ， 

* ”该 寄存 器 通常 是 设置 为 0 的 ,用 来 控制 在 后 台 调 试 模式 时 与 AMMD 转换 相关 的 处 理 器 行为 。 
* “更 详细 功能 介绍 可 查看 HC12 数据 手册 。 

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 了 Bit 2 Bit 1 Bit 0 
b7 

S8C 

S4C 

S2C 

S1C 

FIFEO 

FRZ1 

FR2Z0 

通过 设置 S8C,S4C,S2C,S1C 可 以 设置 转换 序列 长 度 ， 

SBC S4C S2C S1C 转换 序列 长 度 


0 0 0 0 8 
0 0 0 1 1 

0 0 1 0 2 

0 0 1 1 3 

0 1 0 0 4 

0 1 0 1 5 

0 1 1 0 6 

0 1 1 1 7 

1 mi X 江 8 

通过 设置 FRZ1,FRZ0, 可 以 使 能 冻结 模式 的 背景 调试 ， 
FRZ1 FRZ0 工作 状态 

0 0 继续 转换 

0 1 未 定义 

1 0 完成 当前 转换 ,然后 暂停 

1 1 立即 暂停 

* “本 例 中 该 寄存 器 的 值 设 置 如 下 : 

#  b7 0《〈 只 读 位 ) 


*  S8C 0 定义 转换 序列 长 度 

x  S4C 0 同上 一 bit 共同 产生 作用 

<  S2C 0 同上 一 bit 共同 产生 作用 

# SIC 0 同上 一 bi 让 共同 产生 作用 

#* FIFO 0 非 先进 先 出 模式 

# FFRZ1 0 设置 冻结 模式 的 背景 调试 使 能 位 
# FFRZ0 0 同上 一 bit 共同 产生 作用 

* “转化 为 十 六 进 制 表示 为 0x00 

x+ “了 Example: RATDOCTL3 = 0x00; 
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$% 负 设置 RTDOCTL3 寄存 器 的 值 
ATD 多 < atdBank > CTL3 = 0x00; 


/ x* RTDOCTL4 register bits: 

* ”该 寄存 器 用 来 设置 ADC 采 样 时 间 和 时 钟 预 分 频 。 
* ”更 详细 功能 介绍 可 查看 HC12 数据 手册 。 

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
SRES8 

SMP1 

SMP0 

PRS4 

PRS3 

PRS2 

PRS1 

PRS0 


通过 设置 SMP0 和 SMP1 可 以 设置 4 种 采样 率 ， 


SMP0 ”SMP1 采样 时 间 

0 0 2 RM/D clock periods 
0 1 4 Ra/D clock periods 
1 0 8 RM/D clock periods 
1 1 16RA/D clock periods 
通过 设置 PRS0-PRS4 可 以 对 8MHz 的 时 钟 信 号 进行 预 分 频 处 理 ， 
PRSO-PRS4 预 分 频 系数 
00000 

00001 /4 

00010 /6 

00011 /8 

00100 /10 

00101 /12 

00110 /14 

00111 /16 

01Xx2xx 

工 XXXX 


* “本 例 中 该 寄存 器 的 值 设 置 如 下 : 

* ”SRES8 1 RATD 分 辩 率 设置 为 8-bits 

*  SMP1 0 采样 时 间 选 择 
0 同上 一 bit 共同 产生 作用 
0 默认 /12 分 频 

#* PRS3 0 同上 一 bit 共 同 产生 作用 
1 同上 一 bit 共同 产生 作用 
0 同上 一 bit 共同 产生 作用 
1 同上 一 b 让 共同 产生 作用 


， 关 基于 模型 的 设计 一 一 MCU 篇 


* 转化 为 十 六 进 制 表示 为 0x85 
# Example， ATDOCIL4 = 0x85; 
其 

s $% 设置 ATDOCTL4 寄存 器 的 值 
RATD < atdBank > CTL4 = 0x85; 


# 有 ATDOCTL5 register bits: 

* ”该 寄存 器 用 来 设置 RMMD 转换 模式 ,通道 选择 和 初始 化 。 若 在 转换 进行 过 程 中 对 寄存 器 进行 操 
* “ 作 ,转换 进程 将 会 终止 并 执行 写 人 寄存 器 的 指令 。 

* 更 详细 功能 介绍 可 查看 BC12 数据 手册 。 

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 B 让 0 


通过 设置 cc,CB,CR 选择 输入 通道 ， 
CC CB CR 输入 通道 


0 0 0 ANO 
0 0 1 ANT 
0 1 0 有 NZ2 
0 1 1 EN3 
1 0 0 AN4 
和， 浊 AN5 
1 0 AN6 
1 有 RN7 


* “本 例 中 该 寄存 器 的 值 设 置 如 下 : 
# DJM 1 结果 寄存 器 数据 存储 方式 为 右 对 齐 
x*  DSGN 0 以 有 符号 数据 形式 存储 在 结果 寄存 器 中 
SCRMN ”1 连续 转换 序列 模式 
MULT “0 使 用 单 通道 转换 
# CD x 通道 选择 位 
CC x 同上 
CB x 同上 
CR x 同上 


# 转化 为 十 六 进 制 表示 为 0XRO 

x# 上 xample: ATDOCTL5 = 0xa0 

# 写 人 ATDxCTL5 指定 的 低 4 位 (例如 ,bits CD,Ccc,CB,CaA) 启 动 一 个 通道 上 的 MD 转换 
x / 


， "204 昌 
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第 endfunction 


第 区 了 unction: Outputs 


一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 
二 二 三 三 三 三 三 三 三 三 三 三 三 三 三 二 二 二 二 二 三 三 三 三 三 三 三 三 二 二 二 二 二 二 二 三 三 三 三 三 三 三 二 二 三 二 二 三 二 二 三 三 二 三 三 三 二 二 


向 第 

当 负 mdlOutputs 方法 的 代码 生成 规则 

币 季 

秽 function Outputs(block，system) Output 

/#* SFunction "RDC_examp "Block:， %<Name>x/ 

先 第 

针 负 确认 RATD bank 为 bank0 或 bank1l 

% assign atdBank = CRST( "Number ",SEFcnParamSettings.RTDBank) 
先 第 

币 asSSsign nPars = SIZE(SFcnParamSettings. Channels,1) 

第 assign nextChannel = 0 

/*#* 在 选 定 的 通道 上 作 AD 转换 * / 

贞 foreachidx = nPars 

名 assign channelIdx = CRST(" Number ",SFcnParamSettings. Channels[ idx]) 
RATDg 贡 < atdBank > CTL5 = 0x8 蔬 < channelIdx>; 

while (CCE $< channelIdx> 肿 < atdBank>&0O) { 

/* 等 待 转换 完成 的 标志 (CCEX) * / 

} 

多 assign Y = LibBlockOutputSignal(0，"”"，""， 币 < nextChannel >) 
负 assign Usel0BitResolution = ... CAST(" Number ",SFcnParamSettings. Usel0BitRes) 
各 竺 

负 争 确认 RATID bank 为 bank0 或 bank1 

第 assign LeftJustify = CAST(” Number ",SFcnParamSettings. LeftJustify) 
先 第 

争 让 (和 <Usel0BitResolution >) 

1/ # 10-bit resolution 关 / 

种 让 (第 < LeftJustify>) 

/* 左 对 齐 方式 */ 

征 <Y>= (uint16 T) AIDY% < atdBank > DR< channelIdx ><< 6; 

秽 else 

/#* 右 对 齐 方式 * / 

%<yY>= (uint16_T) RTD 外 < atdBank > DR% < channelIdx>; 

$ endif 

币 else 

1/ x#r 8-bit resolution # / 

攻 <Y>= (uint8_T) RATD 世 < atdBank > DR 多 < channelIdx >; 

第 endi 工 

第 assign nextChannel = nextChannel + 1 

Y endforeach 


加 25205B 
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第 endfunction 

上 述 代码 并 没有 以 头 文件 的 形式 给 出 设备 的 存储 器 状态 ,而 是 直接 在 Start 方法 中 定义 
了 ATDOCTL2 = 0x80,ATDOCTL3 = 0x00，ATDOCTL4 三 0x85，ATDOCTL4 一 0x85 。 
Outpnuts 中 则 分 别 定 义 了 8 位 和 10 位 时 的 输出 。 


3. 创建 ADC 模块 


在 Simulink 库 浏览 器 窗口 ,选择 菜单 项 File->New-~>Library, 打 开 库 编辑 窗口 ,并 将 Sim- 
ulink 模块 库 中 的 User-Defined Functions 一 S-Fuction 模块 加 人 到 库 编 辑 窗口 中 ,如 图 4. 4. 1 
所 示 。 


六 则 iodeHWide Utilties 
盖 Ports & Subsystems 


| 
SignalAttributes | En 
-Signal Routing 中 》 system 
sinka -| 

| 





Sources 


- User-Defined unciions S-Furnection 


| 进 Addftional Math & Discrete 
所 - + 了 六 Erospace Blockset 


4.4.1 SS 函数 模块 


双击 SFunction 模块 ,设置 其 对 应 的 S 项 数 名 为 ADC_examp, 如 图 4. 4. 2 所 示 。 并 命名 
为 ADC_examp_lib. mdl, 保 存 于 同一 个 目录 下 ,如 图 4.4. 3 所 示 。 

为 了 使 用 方便 ,对 该 模块 作 Mask 处 理 , 以 便 能 够 用 GUI 窗口 设 定 模块 参数 。 右 击 模块 ， 
在 弹出 右键 菜单 中 选择 Mask SFunction 命令 ,如 图 4.4.4 所 示 。 


广 Parameters 
| 


S-furnctiIon mame: [apc_exanp Edit 





图 4.4.2 设置 S 函 数 名 








易 Ubrary ADC_examp _ 绩 
| Fle Edit View Forma Help 
口 | 态 加 和 印 | 电 命 站 四 










S-Function Parameters.,. 


L Requirements 


S-Function | S_Fur 





Unear Analysis 
1125% Edea 一 | Mask S-Funcbon... 











图 4.4.3 S 函 数 模型 图 4.4.4 封装 S 函数 


第 4 章 设备 驱动 模块 的 编写 [时 


在 Mask Editor 中 选择 parameters 选项 卡 , 单 击 按钮 zx 添加 5 个 参数 ,如 图 4.4. 5 所 示 。 


一 一 一 一 一 ee 






齐 Mask Editor : S-Function 








Icon 到 ports Parameters | Initalization| Documentation| 


马 
二 
| 
四 
吾 
包 
权 
局 
了 
各 
外 
二 
】 呈 










3| | Varable 于 有 
x| 1_IADC bank jibank | PopuP 
2 icChannels(0-7) [channels | edit | 








3 AD5 reselution _juselobits |popup 
leF_justfy 









Woerd alignment 








4.4.5 添加 参数 
其 中 Type 选项 中 ,popup 表示 下 拉 菜 单 型 参数 ,edit 表示 用 户 输入 型 参数 。 因 此 ,需要 在 
在 Options for selected parameters 区 域 为 下 拉 菜 单 型 参数 添加 菜单 选项 。 
首先 选中 ADC bank 参数 ,设置 如 图 4. 4.6 所 示 。 
然后 选中 ADC resolution 参数 ,设置 如 图 4.4.7 所 示 。 


FrOptions for selected Parameter rOpbons for selected Parameter 一 一 
FType-specific options FTypPe-speclfic options 
Popups popups| 
和 | enhits 
1 | jio bits 
图 4.4.6 ADC bank 参数 图 4.4.7 ADC resolution 参数 


再 选中 Word alignment 参数 ,设置 如 图 4. 4. 8 所 示 。 


-Options for selected Parameter 


Type-speciflic options 





图 4.4.8 ADC resolution 参数 


完成 设置 后 单 击 apply 按钮 ,这 时 再 次 双击 模块 时 ,将 会 弹出 一 个 参数 设置 对 话 框 要 求 用 


户 输入 参数 ,如 图 4.4. 9 所 示 。 
”在 Mask Editor 中 设置 好 参数 后 ,还 需要 将 这 些 参 数 与 已 编写 的 SFunction 参数 关联 起 


一 
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来 ,用 户 可 以 在 SFunction Parameters 中 完成 该 任务 。 


贡 | Function Block parameters: S-Function 


S-Function (mask) 


广 ParameterS 


apc bank | | 
Charmels(0-7) 


1 





apCc resolution [s bits | 
Word aligrnment [ett justify | | 


Sample +tIme 





4.4.9 参数 设置 对 话 框 
右 击 模块 ,在 弹出 菜单 中 选择 S-Function Parameters, 图 4. 4. 10 所 示 。 


Copy 
belete 







ADC_examf 
| IMask Parameters... 


S-Function S-Function parameters,.， 


Block Properties,.. 


图 4.4.10 S 函 数 参 数 菜单 


在 parameters 区 域 的 SFuction Parameters 中 输入 :uint8(bank-1)，uint16 (channels ) ， 
uint8(usel0bits-1) ，uint8(left_justify-1) ,sampletime, 如 图 4. 4. 11 所 示 。 应 当 注 意 的 是 参数 
的 数据 类 型 应 该 与 已 编写 的 SFunction 中 声明 的 参数 相同 ,并且 排列 顺序 应 与 Mask Editor 
中 定义 的 参数 顺序 相 一 致 。 


广 Parameters - ee iiasensphiamosoaiiag 


| 
| S-furnctIion mname: [Apc_exanp Edit | 


S-function parameters: juint8(bark-1)，uint16(channels)， 


S-funmction modules: 『 








图 4.4.11 设置 S 函数 参数 
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保存 模型 后 ,将 ADC_examp. c 保存 在 当前 工作 目录 下 ,并 在 命令 行 输入 以 下 代码 ,编译 
该 S 男 数 , 即 可 完成 该 Inlined Deviec Driver。 


mex ADC_exanmp.c 


4. 测试 模型 


若 缺 乏 硬 件 , 这 样 的 模型 是 无 法 仿真 的 ,读者 也 无 法 得 知 S 函数 是 否 正确 。 这 里 设计 一 个 
简单 的 模型 ,并 对 原 S 函数 稍 作 修改 ,利用 参数 传递 ,部 分 验证 S 函数 的 正确 性 。 
原始 的 S 函数 代码 : 


Switch(Yy0DataTYpe) 
{ 
/* 数据 为 uint8 型 时 的 输出 * / 
Case 5S_UINTS8 : 
{ 
uint8_T x* pPY0 = (uint8 T x* )SSGetOutputPortSignal(S,0); 
InputUInt8PtrsTYpe pU0 = (InputUInt8PtrsTYpe)u0Ptrs; 
Int 1; 
/* 把 输入 信号 赋 给 输出 端口 * / 
for( = 0; <YyYoOWidthi + 二 ){ 
PpY0[i] = xpUo[i]; 
/* 采 用 默认 的 右 对 齐 方式 ，* / 
} 
brealk; 


调整 如 下 : 


Switch (yY0DataTYpe) 
{ 
/* 数据 为 uint8 型 时 的 输出 * / 
casSe SS_UINT8 
{ 
uint8 T * pY0 = (uint8_T * )ssGetOutputPortSignal(S,0); 
InputUInt8BPtrsTYPpe pU0 = (InputUInt8PtrsTYPpe)u0Ptrs; 
Int 工 ; 
/* 把 输入 信号 赋 给 输出 端口 * / 
for(1I= 0;1<YoOWidth;， + +i)i{ 
pY0LO] = N_PRRi; 
/* 采 用 默认 的 右 对 齐 方式 */ 
} 
break; 
YL1] = SRAMPLE_TIME ; // 输 出 的 第 2 个 元 素 为 参数 :采样 时 间 
} 


再 次 编译 并 进行 仿真 ,可 以 看 到 S 函数 模块 正确 输出 了 预先 定义 的 参数 个 数 , 如 图 4.4. 12 
所 示 。 


2205D 


可- 基于 模型 的 设计 一 一 MCU 篇 





Display 


图 4.4.12 S 函数 模块 仿真 结果 


4.4.2 ”DAS1600 数据 输入 模块 


本 节 以 DAS1600 系列 数据 采集 卡 为 例 ,编写 其 数字 输入 (digital input) 模 块 。 全 过 程 包 
括 编 写 S 函数 、TLC 文件 ,以 及 模块 封装 与 简单 测试 。 由 于 涉及 硬件 , 若 用 户 手 头 并 无 实际 板 
卡 , 可 不 必 拘 泥 于 函数 中 各 种 赋值 .判断 .输出 等 算法 , 仅 需 了 解 实际 S 函数 的 结构 。 若 要 深入 
研究 ,请 参考 DAS1600 系列 数据 采集 卡 的 用 户 手 册 。 


1， 编写 nonlined S-function 


首先 根据 4. 2. 2 节 中 的 S 函数 模板 ,编写 非 内 联 的 S 函数 (nonlined S-function) ,为 与 上 
文保 持 一 致 ,这 里 依然 分 段 说 明 S 函数 。 
(1) 文件 头 部 。 


// 定 义 函 数 名 ,天 数 级 别 ,加 入 头 文件 

# define S_FUNCTION_ NAME dasl6di 

井 define S_ FUNCTION _ LEVEL 2 

## include < stdlib.h > 1/ x# malloc()，free()，strtoul() #/ 


## include "simstruc.h” 


// 该 上 文件 仅 用 于 生成 CMEX S 本 数 

井 ifndef MRTLRB MEX_FILE 

井 error "dasl6di.c can only be used as a C-MEX SFunction.” 
井 end ii 


// 定 义 各 种 变 基 
# define NUM_PARRAMS 4 // 定 义 参 数 个 数 为 4 
# define BASE_ADDRESS PARAM (ssGetSFcnParam(S,0)) 

// 获 取 第 1 个 参数 数组 :基地 址 
井 define NUM_CHANNELS_PRRRM(sSsGetSFcnParam(S,1)) 

// 获 取 第 2 个 参数 数组 :通道 数 
井 define SRAMPILE_TIME_PRRRM (ssGetSFcnParam(S,2)) 

// 获 取 第 3 个 参数 数组 :采样 时 间 


# define ACCESS_HW_PRARRM (SSGetSFcnParam(S,3)) 
// 获 取 第 4 个 参数 数组 :硬件 访问 使 能 
#define NUM_ CHANNELS ((uint_T) mxGetPr(NUM_CHRNNELS_PRARRRAM)[0]) 
// 获 取 通 道 数 参 数 数组 的 第 1 个 元 素 ,并 转换 为 无 符号 整 型 
提 define SAMPLE_TIME ((real_T) mxGetPr(SAMPLE_TIME_PRRRAM)[0])》 


// 获 取 采 样 时 间 参 数 数组 的 第 1 个 元 素 ,并 转换 为 实 型 


.210 。 
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# include "dasl6di.h* // 加 入 硬件 头 文件 
## ifndef ARCCESS HRW 





# define ARCCESS_HW (mxGetPr(RCCESS_HW PRRRM)[0] != 0.0) 
井 endif // 获 取 硬 件 访 问 使 能 参数 数组 的 第 1 个 元 素 
# define BASE_RADDR_PRRRM STRLEN 128 /7 定义 基 地 址 参数 数组 的 长 度 
typedef struct { // 定 义 结构 体 DIInfo, 其 中 包含 变量 baseaddr 
Uint 了 T baseRaddr; 
}】DIInfoi 


《2) 参数 检查 与 错误 处 理 。 正 如 第 4. 2. 2 节 提 到 的 ,对 于 需要 引入 参数 的 S 函数 ,一 般 都 
要 进行 参数 检查 ,在 模型 初始 化 时 应 首先 调用 该 回调 方法 。 


# define MDL_CHECK_ PARAMETERS 
# if defined(MDL_CHECK_PRRRMETERS) && defined(MATLAB MEX FILE) 





static void md]lCheckParameters(SimStruct * S) 
{ static char_T errMsgL256];  // 定 义 一 个 静态 变量 ,用 于 保存 错误 信息 文字 
boolean_ T allParamsOK = 1; // 所 有 参数 正确 标志 
// 判 断 地 址 是 否 为 字符 类 型 
放 〈!mxIsChar(BRSE ADDRESS_PRRAM) ) 
{ sprintf(errMsg, ”Base address parameter must be a string.Nn”); 
allParamsSOK = 0; 
goto EXIT POINT; 
} 





// 判 断 通道 数量 是 否 为 标量 数值 ,如 果 为 一 组 向 量 , 则 退出 
三 《mxGetNumberOfEJements(NUM_CHANNELS PRRRM) != 1) 
{ sprintf(errMsg， "Number of channels parameter must be a scalar.\nn); 
// 将 错误 信息 文字 保存 在 静态 变量 errMsg 
alJlParamsOK = 0; 
goto EXIT _ POINT; 
} 
// 调 用 diIsNumChannelsParamOK 判断 通道 数 是 否 在 预定 的 范围 ,该 函数 定义 在 dasl6di.h 
让 〈1diISNumChanne1sParamOK(NUM_CHRNNELS) ) 
{ sprintf(errMsg，" The number of channels must be between 1 and 儿 d\n",DI_MRX_CHRNNELS) ; 
// 将 错误 信息 文字 保存 在 静态 变量 errMsg 
alJParamsOK = 0; 
goto EXIT POINT; 
} 





// 判 断 采 样 时 间 是 否 为 标量 数值 ， 
if (mxGetNunberOfElements(SAMPLE TIME PRRRM) 1= 1) 
{ sprintf(errMsg，"Sample Time must be a positive scalar.\n"); 
allParamsOK = 0; 
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goto EXIT POINT; 
} 


// 判 断 硬件 访问 标志 位 ,或 为 0, 或 为 1, 如 果 为 其 他 数字 则 退出 
if (RCCESS_ HI != 0 8&& RCCESS HW != 1) { 
sprintf(errMsg,，" Hardware access parameter is 第 d，expecting 0 or 1.\n"，RCCESS_HN); 
// 将 错误 信息 文字 保存 在 静态 变量 errMsqg 
allParamsOK = 0; 
goto EXIT POINT; 
} 


// 错 误 处 理 
EXIT POINT， 
if (1al1ParamsOK) 
ssSetErrorStatus(S，errMsg); 1 /将 变量 errMsg 的 错误 信息 输出 
} 
井 endi 


《3) 模型 初始 化 。 这 是 Smulink 引擎 调 用 的 第 一 个 回调 方法 ,首先 进行 参数 检查 ,确保 
正确 后 再 定义 采样 时 间 个 数 、 输 入 /输出 口 个 数 .输出 口 维度 等 。 
static void mdlInitializeSizes(SimStruct #*S) 
{ 。 SsSetNumSFcnParams(S，NUM_PRRRMS) ; 
让 (ssGetNumSFcnParams(S) == SSGetSFcnParamsCount(S) ) 
{ mdlCheckParameters(S); 7// 如 果 参 数 数目 正确 , 则 开始 检查 参数 数值 
应 (ssGetErrorStatus(S) 1= NULL) 


returni // 如 果 参 数值 不 正确 ,终止 仿真 
} 
else 
returni; // 如 果 参 数 数目 不 正确 ,终止 仿真 
// 设 置 所 有 的 参数 ,在 仿真 阶段 不 可 调 
{ int Ti 


for (1=0; I<NUM PARAMS; i+ 二 ) 
SSsSetSFcnParamNotTunable(S，i); 
} 


ssSetNumSampleTimes( S，1 ) ; /设置 采样 时 间 个 数 为 1 
ssSetNumInputPorts( S，0) ; // 源 模块 ,因此 设置 模块 输入 口 数量 为 0 
ssSetNumOutputPorts( S，1); // 设 置 输出 口 数 基 为 1 


ssSetOutputPortwidth(S，0，NUM_CHANNELS) ;// 设 置 输 出 口 维度 为 通道 数 
} 
(4) 初始 化 采样 时 间 。 根 据 输 和 人 参数 ,定义 采样 时 间 值 。 


static void mdlInitializeSampleTimes(SimStruct # S) 
{ ssSetSampleTime(S，0，SRAMPLE TIME) ; // 根 据 输 入 参数 设置 采样 时 间 
ssSetOffsetTime(S，0，0.0); // 设 置 采 样 时 间 偏 移 量 为 0 
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} 


《5) 回调 方法 mdlStart。 判 断 硬 件 访 问 的 使 能 位 ,如 果 人 允许 访问 , 则 继续 判断 硬件 是 否 准 
备 就 缚 ,否则 即 认为 硬件 无 法 访问 ,仿真 终止 。 如 果 用 户 没 有 实际 板 件 , 应 定义 使 能 位 为 0, 不 
访问 硬件 。 

# define MDL STRRT 

地 if defined(MDL_ STRRT) 

Static void md]lStart(SimStruct # S) 

{ 证 CRACCESS_HW) 

{ _ // 初 始 化 结构 体 diInfo 
DIInfo * diInfo = SSGetUserData(S); 
char_ T baseaddrStrL BRSE_ADDR_ PARAM_STRLEN] ; 
Ulint_ T basehddr; 
mxGetString(BASE_ADDRESS_PARAM，basehddrStr，BRSE_RADDR_PRRAM STRLEN) ; 
baseahddr = (uint T) strtoul(baseahddrStr，NULL，0) ; 
if (diInfo != NULD) 
freekdiInfo) ; 
if((diInfo = malloc(sizeof(DIInfo))) == NULL) 
{ ， ssSetErrorStatus(S，MemorYy Al1location ErrorNn ") ; 
return; 
diInfo 一 > baseacdr = basehddr; 
ssSetUserData(S，(voidx ) diInfo) ; 
mexPrintf(n\ndasli6di， Hardware RMccess EnabledNvn") ; 


else jif〈ssGetSimMode(S) == SS_SIMMODE NORMRATL) 
mexPrintf(\ndasl6di: Hardware Rhccess Disabled\n") ; 
) 
间 endi 工 


(6) 计算 模块 输出 。 当 硬件 可 访问 时 ,调用 函数 diGetInputOnChannel 计算 输出 ,该 冰 数 
定义 在 头 文件 das16di. h; 若 硬件 不 可 访问 ,各 通道 均 输 出 0。 


Static void nd]Outputs(SinmStruct *S，int Ttidy) 
{ real T *Y = ssGetOutputPortRealSignal(S,0); 
uint T ji 
if (RMCCESS_HW) /如 果 硬 件 可 访问 
{ DIInfo * diInfco = ssGetUserData(S) ; 
uint_T basehddr = diInfto 一 > basehddr; 
uint_T inputs = diReadRAl1InpChannels(basehddr) ; 
for (i = 0;i i < NUM _ CHANNELS; i+ +) 
{Y[il = diGetInputOnCchannel(i,inputs);}) // 将 各 通道 数据 依次 输出 
} 
Else /如 果 硬 件 不 可 访问 
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{for (i = 0; i< NUM_CHANNELS; i+ +) 
{ 了 Li = 0.0;)} // 各 通道 输出 为 0 


} 
《7) 果 数 结束 。 


Static void mdlTerminate(SimStruct 关 S) 

{ DIInfo * adcInfo = ssGetUserData(S) ; 
free(adcInfo) ; 
ssSetUserData(S,NULL) ; 

} 


《8) 回调 方法 mdlRTW。 该 方法 主要 用 于 RTW 代码 生成 工具 生成 model. rtw 文件 。 


井 define MDL_RIW 
# if defined(MDL _RTW) SS (defined(MRTLRB MEX_ FILE) | | defined(CNRT)) 


Static void mdlRTWCSimStruct x* S) 
{ char_ T baseaddrStrLBASE_RDDR_PRRRM_STRLEN ]; 
mxGetString(BRASE ADDRFSS_PRRRM，baseRddrStr， 
BASE _RADDR_PRRRM STRLEN) ; 
(volid)SssWriteRTWParamSettings(S，1，SSWRITE_ VALUE _QSTR， 
“Baseahddress ",basehddrStr); 
} 
# endi 开 


(9) 文件 尾部 。 由 于 该 C 文件 仅 用 于 生成 C-MEX S 函数 ,因此 这 里 只 需 包 含 simulink. c 
文件 。 


# include "simulink.c" / *# Required include for MEX interface mechanism xx / 


2. 编写 TLC 文件 


凶 implements "dasli6di cn" 


#% g$ 了 晒 数 BlockInstanceSetup 
贡 function BlockInstanceSetup(block，system) void 
第 if 1EXISTS(" Drt_ das16di") 
多 assign ::Drt dasl6di = 1 工 
和 obpenftile buffer 
# include " dasl6di.h" 
凶 ClLlosefile buffer 
和 < LibCacheIncludes(buffer)> 
第 endif 
$ endfunction 纪委 BlockInstanceSetup 


负 有 陋 数 0utputs 


。214 中 
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各 function Outputs(block，syYystem) Output 
/# 岂 <TYPe> Block:， %<Name> (外 < ParamSettings.FunctionName >) #x / 
{ 
第 assign numChannels = LibData0utputPortmidth(0) 
$ assign baseaddr = SFcnParamSettings. Baseaddress 
uUint T diInput = diReadhl1l1InpChannels( 多 < baseRkddr >) ; 
币 assign rollVars = ["Y "|] 
外 assign rollRegion = [0:$%<numchannels-l >] 
先 ZOL1 idx rol1Region，lcv = RollThreshold，block, "Roller "，rollVars 
第 assign yY = 工 ibBlockOutputSignal(0，"”"，lcv，idx) 
多 <Y> = diGetInputOnChannel( 包 < idx>，diInput); 
外 endrol1 


贞 endfunction 向 先 Outputs 


3。 头 文件 


涉及 硬件 的 头 文件 ,这 里 仅 简单 罗列 ,不 作 解 释 。 
和 das16di. h 
井 ifndef __ DRS16DI 有 


# define “DRhS16DI 
井 include "tmwtypes.h" 


井 define DI_MRAX_CHANNELS (4) // 定 义 通道 数 
井 define diIsNumChannelsParam0K(n) (1<= nS&&gn<= DI MAX CHRNNELS) 
// 判 断 S 函数 参数 是 否 与 I/0 板 卡 兼容 


井 include "drt_comp.h" 

# define DIGITRL IO_REG(bR) (bR + 0x3) // 硬 件 寄 存 器 

# define diReadRllInpChannels(bR) /访问 I/0O 板 卡 上 的 数字 输入 部 分 
(ReadByYteFromHwPort(DIGITRL IO_REG(baA) )&Oxf) 

# define diGetInputOnChannel(iyv) ((real T) ((vV>> i) &0xl)) 
#endif /* DRS16DI _ #*/ 


@@ drt_comp. h 


# ifndef DRT_COMPILERS 
# define DRT_COMPILERS 
# ifdef _ WaTCOMC 

# include < dos.h> 

# include < conio.h > 


井 define EnableInterrupts _enable( ) 

# define DisableInterrupts _disable() 

# define GetIntrVector(Cnum) _dos _ getvect(num) 

# define SetIntrVector(num, isr) _dos_setvect(num, isr) 
井 define ISR_PTR_TYPE _interrupt _far 


人 “215” 
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# define ReadBYteFromHwPort(Caddr) inp(addr) 

## define WriteByteToHwPort(addr ,val) outp(addr ,val) 

井 else 

# ifdef MATLAB_ MEX FILE 

井 。 define ACCESS_HW 0 

井 。 define ReadByteFromHwPort(addr) 0 

## define WriteByteToHwPort(addr ,val) /* do nothing */ 
# endi 

# 井 endif / * _WRTGOMC _ #/ 

#endif / * _DRT_COMPILERS xy/ 


4. 设置 S 函数 模块 
由 于 该 S 函数 含有 参数 检查 ,为 避免 因 参 数 检 查 失 败 而 无 法 继续 其 他 操作 ,首先 进行 S 郴 
数 的 封装 ,然后 再 指定 S 函数 名 。 
(1) 模块 封装 。 右 击 SFunction 模块 ,选择 菜单 项 Mask S-Function… ,打开 封装 对 话 框 。 
@ Icon & Ports 面板 。 输 入 以 下 代码 ,定义 模块 的 显示 文 


字 与 端口 文字 ,如 图 4.4. 13 所 示 。 
Digital Input 可 
disp(Digital Input )); 


S-Function port_label( output '，1，'di7); 


@ Parameters 界面 。 新 建 4 个 参数 ,如 图 4.4. 14 所 示 ,其 
中 Prompt 列表 示 封 装 之 后 ,模块 对 话 框 各 条 目的 提示 文字 ， 
Variable 列表 示 该 参数 所 对 应 的 变量 名 。 


图 4.4.13 SS 函数 外 观 文字 


jcon 及 Ports，pParameters . jnriaiization | Documentation 


Dialog parameters 


Ed 关 Prompt Variable Type Evaluate Tunabje Tab name 
> |Base Address ba | edit us | 
、 2 Channels ch ed 让 | | 
一 昌 SampleTime 入 | ed | v | 
香 4 贞 ccess Hardware iah [edt | Y | 


图 4.4.14 Parameters 界面 

基地 址 参数 Base Address 的 输入 值 为 字符 ,因此 必须 取消 该 参数 的 Evaluate 项 目 , 和 否则 
将 来 仿真 时 系统 会 提示 无 法 处 理 该 类 数据 。 

@) Initialization 界面 。 在 初始 化 面板 ,使 用 函数 set_param( ) ,预定 义 S 函数 模块 的 参 
数 , 例 如 : 

set_param(gcb，ba ', 0x300 "ch', 27 st', "0.1 ah 017) 

用 户 还 可 以 在 Documention 面板 输入 模块 更 详细 的 描述 文字 ,本 文 从 略 。 封 装 完 成 后 ， 
双击 S 函数 模块 ,得 到 封装 后 的 模块 对 话 框 , 如 图 4. 4. 15 所 示 。 

(2) 模块 定义 。 右 击 SFunction 模块 ,选择 菜单 项 Look Under Mask ,打开 S 函数 参数 设 


:CE 家 
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著 对 话 框 ,定义 其 函数 名 与 变量 名 ,如 图 4. 4. 16 所 示 。 
变量 名 应 与 Parameters 面板 中 定义 的 一 致 。 


DAS1600 Digital IJnptt (mask) > 





Parameters 





Base Address 
| “0x300 
| Channels 
| 2 Paframeters 
| Sample Time S-function name: dasl6di [Edg 一 ] 
和 5-function parameters: ba,ch,stiah 
| 上 Access Hardware 


S-function modules: " 
| 0 


Help 





上 sjcance | bep | OK Cancel 





图 4.4.15 封装 后 的 模块 对 话 框 图 4.4.16 S 函数 参数 设置 对 话 杠 
确定 后 ,得 到 最 终 的 模块 ,如 图 4.4. 17 所 示 。 


Digital Input 册 


DAS16di 





图 4.4.17 DAS1600 数据 输入 模块 


sS.。 测试 模型 


若 缺 乏 硬件 ,这 样 的 模型 是 无 法 仿真 的 ,读者 也 无 法 得 知 S 函数 是 否 正确 。 这 里 设计 一 个 
简单 的 模型 ,并 对 原 S 函数 稍 作 修改 ,利用 参数 传递 ,部 分 验证 S 函数 的 正确 性 。 
原始 的 S 函数 代码 : 


static void mdlOutputs(SimStruct x* S，int Ttid) 


elsSe 
{for (1 = 0; TI<NUM CHRANNELS; 1i+ +) 
{Y[i] = 0.0;)} 
}》 
调整 为 ， 


Statlic void mdlOutputs(SimStruct x* S，int Ttid) 


elSe 
{ 2L0]j = NOM_CHANNELS; // 输 出 的 第 1 个 元 素 为 参数 :通道 数 
YL1] = SRMPLE_TIME ; // 输 出 的 第 2 个 元 素 为 参数 :采样 时 间 


*2 7 1 
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} 


再 次 编译 ,并 根据 图 4. 4. 15 所 设 定 的 参数 进行 仿真 ,可 以 看 到 S 郴 数 模块 正确 输出 了 预 
先 定义 的 通道 数 与 采样 时 间 , 如 图 4.4. 18 所 示 。 


DAS16di Display 


4.4.18 S 函数 模块 仿真 结果 
4.4.3 S-Function Builder 


1. 创建 S-Function Builder 驱动 模型 


下 面 将 使 用 SFunction Builder 继承 一 个 实现 两 数 相 加 功能 C 代码 。 将 代码 命名 为 add. 
double add(double aydouble b) 
{ double sum= 0; 

Sum= 己 十 bi; 

return SuUmi; 


} 


按照 图 4. 4. 19 新 建 一 个 包含 SFunction Builder 的 Simulink 模型 。Add 模块 完成 相同 
的 两 数 相 加 功能 ,用 于 验证 结果 的 正确 性 。 





Display1 


3S-Function Buildaer 


图 4.4.19 SFunction Builder 模型 


双击 打开 SFunction Builder 模块 , 作 以 下 设置 : 

(1) 在 Sfunction name 字段 中 写 人 add。 

(2) 由 于 本 例 中 不 包含 连续 或 离散 状态 ,初始 化 页 面 不 需要 更 改 。 

(3) 在 Data Properties 中 ,将 输入 /输出 定义 为 inl in2、.outl, 如 图 4.4.20、 图 4.4.21 
所 示 。 
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Port and Parameter properbes 














Input ports | Output portsj Parameters | Data typPe attributes | 


Dimensions| Rows | Columns 


图 4.4.20 Input Ports 界面 





Port and Parameter properties 


Input ports Output Ports | Parameters | Data type 


Dimensions| Rows | columns 
| 


一 一 二 一 ~ 一 -~ 一 一 ~ 一 





alttributes | 







of 全 > 





图 4.4.21 Output Ports 界面 
(4) 在 库 文件 界面 中 的 Library/Object/Source files 区 域 输 入 add. c, 在 external function 
declaration 区 域 输入 extern double add(Cdouble inl ,double in2) ,如 图 4.4. 22 所 示 。 


Library/Object/Source files [one Per |ine) Incude 利 es and external function dedarations 


dd.c “> Includes; 


include 《math, h> 


External function declarations: 
米 SXtert QUD DELQDIIDJLE 本 
Hisxtern double addfdouble inl, double in2) : 


图 4.4.22 库 文 件 界面 
(5) 在 输出 界面 中 写 人 * outl 一 add( # lnl， # In2) ,如 图 4. 4. 23 所 示 。 











Code descrliption 
Enter your C-code or call your algorithm.If available, discrete and continuous states should 上 | 
xD[0]..xDinl xc[0]..xC[n] respectively.Input ports, output ports and Parameters should be re 
symbols specfied in the Data Properties. These references apPear directy in the generateqd 5 





*out 1=add(*imnl, *ir2) ; 


芭 Inputs are needed inthe outputfunction(direct feedthrough) 
vv 


图 4.4.23 输出 界面 
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(6) 单 击 对 话 框 工具 栏 的 Build 按钮 ,编译 信息 窗口 即 显示 完成 信息 ,如 图 4.4. 24 所 示 。 


compilation diagnostics 


= 一 = 一 = 一 一 一 -一 一 一 





科举 addc created SuUCCceSSs 仙 ly 

各 洒 dd WwWrapperc' created SUCCeSsfully 

私 并 addtlc'created SUCcessfully 

让 S-function add.Imexw32 createdl success 人 向 ly 


4.4.24 编译 信息 


按 下 “仿真 ”按钮 ,Add 模块 与 SFunction Builder 得 到 一 致 的 结果 ,如 图 4.4. 25 所 示 , 说 
明 SFunction Builder 实现 了 设计 的 功能 。 


Display 





S-Function 日 uilder 
图 4.2.25 仿真 结果 


2.，S-Function Builder 如 何 创 建 S-Function 
当 用 户 为 SFunction Builder 设置 参数 后 ,S-Function Builder 将 会 在 当前 工作 目录 下 产 


生 下 列 源 文 件 :sfun. csfun_ wrapper. csfun_tlc. csfun_ bus,. h( 其 中 sfun 为 用 户 指 定 的 S 函 
数 名 ) 。 之 后 ,SFunction Builder 将 会 用 mex 指令 把 上 述 源 代 码 和 用 户 指 定 的 外 部 代码 、 库 
文件 编译 成 S 函数 。 


(1) sfun.c 文件 包含 有 生成 'S-Function 标准 部 分 的 C 源 代 码 。 
上 述 例子 编译 生成 的 文件 为 add. c, 部 分 代码 如 下 : 


staticvoidmdlInitializeSizes(SimStruct yx S) 
//mdlInitializeSizes 方法 


ssSetNumSFcnParams(S，NPRRRMS) ;// 设 置 参 数 个 数 
if (ssGetNumSFcnParams(S) != SSsGetSFcnParamsCount(S)) { 
returni // 验 证 参数 个 数 

} 
ssSetNumContStates(S，NUM_CONT _STRTES);，// 设 置 连 续 状 态 个 数 
ssSSetNumDiscStates(S，NUM_DISC_STRTES) ; // 设 置 离散 状态 个 数 


if〈(!1ssSetNumInputPorts(S，NUM_INPUTS) ) returni / /验证 输入 端口 个 数 





第 4 章 设备 驱动 模块 的 编写 村 


// 输 入 端口 0 属性 设置 // 
SSSetInputPortWidth(S，0，INPUT 0 _WIDTH) ; 
SSSetInputPortDataType(S，0，SS_DOUBLE) 
SSSetInputPortCompljexSignal(S，0，INPUT 0_COMPLEX) ; 
SSsSetInputPortDirectFeecThrough(S，0，INPUT 0_FEEDTHROUGH) ; 
ssSetJnputPortRequiredContiguous(S，0，1); 
// 输 入 端口 1 属性 设置 // 

SSSetInputPortWidth(S，1，INPUT 1_WIDTH) ; 
SSSetInputPortDataTYyYpe(S，1，SS_DOUBLE ) ; 
SSSetInputPortComplexSignal(S，1，INPUT 1_COMPLEX) ; 
SSsSetInputPortDirectFeedThrough(S，1，INEUT 1_FEEDTHROUGH) ; 
SSSetInputPortRequiredContiguous(S，1，1); 


if (!ssSetNumOutputPorts(S，NUM_OUTPUTS) ) return; // 验 证 输出 端口 个 数 
// 输 出 端口 0 属性 设置 // 

ssSetOutputPortWidth(S，0，OUTPUT 0_WIDTH) ; 
SSSetOutputPortDataTYpe(S，0，SS_DOUBLE) ; 
SSSetOutputPortCompJlexSignal(S，0，OUTPUT 0_COMPLEX) ; 
SSsSetNumSampleTimes(S，1) ; 

SSSetNumRWork(S，0) ; 

SSsSetNumIWork(S，0) ; 

SSSetNumPWork(S，0); 

SSSetNumModes(S，0) ; 

SSSetNumNonsampledZzCs(S，0) ; 
staticvoidmd]InitializeSampleTimes(SimStruct x* S) //mdlInitializeSampleTimes 方法 
{ 

ssSetSampleTime(S，0，SaAMPLE TIME 0); /设置 采样 时 间 
ssSetOffsetTime(S，0，0.0); // 设 置 偏 置 时间 

} 


staticvoidmdlOutputs(SimStruct x*S，int_Ttid) 
/mdloutputs 方法 


{ 
Constreal T # inl = 〈《constreal Tx ) ssGetInputPortSignal(S,0); 


Constreal 了 T * in2 = (constreal T# ) ssSGetInputPortSignal(S,1); 
real 了 # Outl = 《Teal_ T x* ) SSsSGetOutputPortRealSignal(S,0); 
add_Outputs_wrapper(inl ，in2，outl); 

} 

staticvoidmdlTerminate(SimStruct x S) 

/mdlTerminate 方法 

{ 

} 
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(2) sfun_ wrapper. c 文件 包含 有 在 SFunction Builder 对 话 框 中 输入 的 用 户 代码 。 
编译 生成 文件 为 “add_wrapper. c”, 部 分 代码 如 下 : 

WE ,double in2); // 声 明 外 部 函数 “add” 

voidadd Outputs_wrapper(constreal T * inl， 

COnstreal T x* ln2， 





real T * Outl) 

// 调 用 用 户 代码 

{ 

*# Outl = add( # inl，# in2)3 
} 


(3) sfun. tlc 文件 能 够 使 生成 的 SFunction 在 Simulink 中 以 Rapid Accelerator 模式 运 
行 , 并 且 在 生成 代码 时 允许 内 联 SFunction。 此 外 ,本 文件 还 能 生成 Accelerator 模式 下 的 于 
Function ,用 以 加 速 模 型 运行 。 

编译 生成 文件 为 “add. tlc”, 部 分 代码 如 下 : 


笛 implements add "C"” 
第 unction BlockTYPpeSetup(block，syYstem) Output 
//BlockTypeSetup 天 数 


名 openfile externs 


extern void add _ Outputs_wrapper(Cconstreal T # inl， 
Constreal T x ln2， 
real T x Outl); 

币 closef ile externs 

第 LibCacheExtern(externs)> 


名 endftunct1ion 


$ function Outputs(block，sVystem) Output 
//outputs 函数 
第 assign pu0 = LibBlockInputSignaladdr(0，”"，"”"”，0) 
多 assign pul = LibBlockInputSignalRhddr(1，"”"，"”"，0) 
g% assign pY0 = LibBlockOutputSignalahddr(0，"”"，"”",，0) 
第 assign pPY_width = LibBlockOutputSignalWidth(0) 
外 assign pu_width = LibBlockInputSignalWidth(0) 
add_Outputs_wrapper( 和 < pu0 >， 争 < pul >， 贡 区 PY0O >); 
第 endfunction 


(4) sfun_bus.h。 当 用 户 在 SFunction Builder 的 Data Properties 页 面 中 指定 输入 /输出 
为 总 线 时 ,S-Function Builder 会 在 缺 省 头 文件 时 自动 生成 该 头 文件 。 
由 于 在 上 节 的 例子 中 并 未 将 输入 /输出 指定 为 总 线 , 因 此 并 未 产生 sfun_bus. h 文件 。 


222。 四 
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本 章 重 点 讲述 基于 模型 设计 的 8051 单片机 快速 开发 。 自 动 代 码 生 成 工具 Real - 
time Workshop Embedded Coder 的 设置 ,在 作者 所 著 的 《基于 模型 的 设计 及 其 能 人 式 实 
现 》 一 书 中 已 做 了 详细 介绍 ,有 需要 的 读者 可 以 阅读 相关 内 容 或 参考 MathWorks 公司 的 
技术 手册 。 

一 个 完整 的 基于 模型 设计 的 例子 需要 数 10 页 的 篇 幅 来 进行 介绍 ,为 了 给 读者 呈现 更 多 的 
开发 实例 ,这 里 仅 做 模型 的 功能 验证 ,简单 的 模型 数据 类 型 变换 .软件 在 环 测试 .处理 器 在 环 测 
试 .嵌入 式 实 时 C 代码 的 快速 生成 。 考 虑 到 多 数 读者 不 可 能 拥有 各 种 类 型 的 开发 板 , 本 章 的 
硬件 /硬件 在 环 测试 将 采用 Proteus 虚拟 硬件 测试 平台 进行 ,完整 的 基于 模型 设计 的 例子 将 在 
第 9 章 介绍 。 

本 章 推 荐 读者 采用 MathWorks 人 R2010b 和 TASKING EDE for 8051 v7. 2 rl 进行 基于 模 
型 的 开发 。 这 样 既 能 提高 生成 代码 的 效率 ,还 可 以 减少 后 期 修改 代码 的 工作 量 。 如 果 读 者 不 
习惯 TASTKING EDE 软件 ,也 可 以 采用 国内 流行 的 Keil C51 进行 基于 模型 的 设计 。 

本 章 的 主要 内 容 : 

和 @@ Proteus 快速 人 门 。 

@@ 上 人 eil C51 集成 开发 环境 。 

@ TASKING 艇 入 式 开 发 环境 。 


下 仿真 软件 Proteus 快速 入 门 


Ss. 1.1 Proteus 简介 


Proteus 是 英国 Labcenter 公司 开发 的 电路 分 析 与 实物 仿真 软件 。 它 集成 了 ISIS 原理 图 
绘制 和 ARES PCB 制版 ,是 一 款 功 能 强大 的 EDA 软件 ,同时 具备 完善 的 仿真 功能 ,能 够 支持 
目前 流行 的 大 部 分 单片机 系统 ,如 51 系列 `MSP430、AVR PIC、ARM7 等 常用 主流 芯片 。 还 
可 以 直接 在 基于 原理 图 的 虚拟 原型 上 编程 ,再 配合 系统 配置 的 虚拟 逻辑 分 析 仪 .示波器 等 ,看 
到 系统 输出 效果 。Proteus 建立 了 一 套 完 整 的 虚拟 产品 开发 平台 ,并 且 可 以 和 第 三 方 编译 软 
件 联 调 , 如 Keil IJAR、MPLAB 等 。 


-人 : 
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Proteus 基本 功能 : 

(1) 智能 原理 图 输入 系统 (ISIS) 。 

@ 器 件 库 。 超 过 27 000 种 元 器 件 , 且 用 户 可 自 定义 器 件 。 

Q@ 器 件 搜索 。 通 过 模糊 搜索 功能 ,可 以 快速 找到 用 户 所 需要 的 器 件 。 

@ 自动 连 线 。 智 能 的 连 线 功能 使 连 线 简单 快捷 ,降低 用 户 的 劳动 强度 。 

盐 总 线 结构 。 采 用 总 线 器 件 和 总 线 布线 使 电路 一 目 了 然 。 

@ 多 种 格式 的 输出 。 个 性 化 的 设置 ,可 输出 高 质量 的 BMP 图 纸 , 也 可 生成 Word、Pow- 
erpoint 等 格式 的 文档 。 

(2) 混合 模型 SPICE 仿真 (ProSPICE ) 。 

@ ProSPICE。 采 用 工业 标准 SPICE3F5 ,实现 数 - 模 电路 的 混合 仿真 。 

@) 仿真 元 件 库 。Proteus 目前 拥有 超过 27 000 种 仿真 器 件 ,Labcenter 公司 仍 在 不 断 努 力 
提供 更 多 新 的 仿真 器 件 。 同 时 ,用 户 也 可 通过 内 部 原型 或 厂家 的 SPICE 文件 自 定 义 仿真 元 
件 , 还 可 导入 第 三 方 的 仿真 元 件 。 

@G) 激励 源 。 包 括 直 流 、 正弦、 脉冲 .分 段 线性 脉冲 .音频 .指数 信号 . 单 频 FM ,数字 时 钟 和 
码 流 , 以 及 文件 形式 的 信号 输入 。 

由 虚拟 仪器 。 包 括 示 波 器 .逻辑 分 析 仪 、 信 号 发 生 器 .直流 电压 /电流 表 、 交 流 电 压 / 电 流 
表 频率 计 / 计 数 器 .逻辑 探头 .虚拟 终端 .SPI 调试 器 .下 C 调试 器 等 ,其 优点 是 用 户 可 以 随心 所 
欲 地 使 用 这 些 虚拟 仪器 ,不 再 受 实际 仪器 的 功能 限制 和 价格 限制 。 

@ 仿真 显示 。 用 色 点 标示 引 脚 电 平 的 高 低 , 以 不 同 颜色 表示 导线 上 电压 的 大 小 ,采用 喇 
以 、 蜂 鸣 器 .电动 机 .LED ,液晶 显示 屏 等 ,使 仿真 结果 更 加 通 真 与 生动 。 

@@ 高 级 图 形 仿 真 功能 。 采 用 图 标 , 精 确 分 析 工 作 点 、. 瞬 态 特 性 、 频 率 特 性 、 传 输 特 性 、 噪 
声 .失真 .频谱 等 多 项 电路 性 能 指标 。 

(3) 虚拟 系统 模型 (VSM) 。 

@ 支持 CPU 的 种 类 。8051/52、MSP430、AVR 、PIC10/12、PIC16、PIC18、PIC24 dsPIC33、 
HC11 、BasicStamp、ARM7 .8086 等 ,Proteus 8.0 版 还 将 支持 ARM Cortex 、DSP 等 处 理 器 。 

@) 支持 的 外 设 。 包 括 键盘 /按键 .电动 机 、LCD 模块 .LED 点 阵 、.LED 七 段 显示 模块 .RS232 
虚拟 终端 .电子 温度 计 等 。 且 COMPIM 还 可 通过 PC 串口 和 仿真 电路 实现 双向 异步 串 行 通信 。 

@@ 实时 仿真 :支持 中 断 .SPI/EC、MSSP、PSP、RTC、UARTV/VUSART/VEUSARTs、ADC、 
CCP/ECCP 等 仿真 。 

田 支持 联 调 。 支 持 汇 编 语 言 的 编辑 /编译 /源码 级 仿真 ,内 带 8051、.AVR、PIC 的 汇编 编 
译 器 ,也 可 以 与 第 三 方 集成 编译 环境 (如 IAR Keil.MPLAB) 无 颖 连接 ,实现 联 调 功 能 ,就 像 接 
上 仿真 器 一 样 方便 。 

(4) PCB 制作 。 

@ 原理 图 到 印 制 电路 板 的 一 键 功能 。 原 理 图 绘制 完成 ,再 经 过 仿真 验证 其 功能 后 , 便 可 
一 键 转 和 人 ARES 的 PCB 设计 环境 ,大 大 简化 后 续 的 设计 。 

@) 自动 布局 /布线 。 支 持 器 件 的 手工 /自动 布局 .无 网 格 自动 布线 或 手工 布线 . 引 脚 交 换 / 
门 交 换 等 功能 。 

@) 优异 的 PCB 设计 功能 。 支 持 多 达 16 个 铜 销 层 ,2 个 丝印 层 ,4 个 机 械 层 ,支持 3D 动画 
以 找 出 设计 中 难以 发 现 的 甫 竟 ,灵活 的 布线 方案 供用 户 选 择 ,支持 自动 设计 规则 检查 等 。 

昌 多 种 输出 格式 。 支 持 Gerber 文件 的 导入 或 导出 ,支持 与 其 他 PCB 设计 软件 的 转换 、 设 
计 和 加 工 。 
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下 面 将 以 Proteus 7.7 sp2 版 为 例 讲 述 Proteus 的 使 用 方法 。 


5.1.2 快速 绘制 原理 图 


绘制 原理 图 是 Protues 仿真 软件 的 基础 ,本 节 将 在 ISIS 原理 图 绘制 系统 中 完成 一 个 实际 


的 单片机 仿真 电路 。 


(1) 双击 ISIS 图 标 , 打 开 原 理 图 绘制 界面 ,出 现 图 5. 1. 1 所 示 的 默认 模板 ,下 面 的 例子 将 


在 默认 模板 中 完成 。 





-六 计 预览 窗 吕 


ns 旋转 /镜像 工具 栏 





ae 
ae 模式 工具 栏 
一 工 绘图 具 栏 
me 仿真 按钮 

A 

0 仿真 日 志 
Ca 一 ~ 


图 5.1.1 原理 图 绘制 界面 


比较 熟悉 Proteus 的 用 户 也 可 以 选择 其 他 更 合适 自己 的 模板 。 在 菜单 中 选择 FileNew 
Design 命令 ,弹出 的 对 话 框 中 列 出 了 所 有 可 用 模板 ,如 图 5. 1. 2 所 示 。 


区 New Deslgn 


Selecl a lemplate lo act as the defak for the new deslon 


| 


DEFAULT “LandscapeAn0 LandscapeAl LandscapeA2 LandscapeA3 LandscapeA4 


Landscape Us LandscapeUS LandscapeUS PortatAD 
丰 B 


PortraA3 





要” 


四 国 国 国 国 台 


辐 国 国 国 国 国 


PortratA1 Portra%A2 


PortratAd4 PortratUS 上 二 PortraitU5SB PortraU5C 





| DAProgram Files\Labcenter Elechomics\Proleus 7 ProfessionafTEMPLATESADEFAULT.DTF 





一 CE] 


s.1.2 选择 模板 


“225 。 ; 





基于 模型 的 设计 一 MCU 篇 


(2) 单 击 按钮 或 选择 菜单 项 Library->Pick Device/Symhbol ,在 Pick Device 对 话 框 中 选择 


所 需 的 元 件 ， 如 图 5. 1. 3 所 示 。 


rm wa 
四 Rick ae 
Koymords es NoFie 四 5chemahc Preview- 
| | Device 
Mach whole Words7? | 
Show on palts with models7 | 
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| jcwos 4000 Selles 








induceion _ PCB Pi 

| Mecharvcs ] No search cieria 

;Memory ICs Pisase erier ome 0f mate kewWolds avd/al 

] MiCioptocaessor |CS | SelectaCalegoty, Subcategowy or Manufacturer- 






ESESSEESSSOESSESSRSRSSSESRRSRSESESRNRCAORRNNNNNNNNNNNRAANNNINEIGNNNS 
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图 S$.1.3 元 件 库 对 话 框 


ISIS 提供 了 两 种 选取 元 件 的 方法 :可 以 通过 左 侧 的 目录 区 逐 级 向 下 查找 ,也 可 在 左上 方 


Keywords 区 域 中 输入 元 件 名 称 ,进行 模 糊 查找 。 


例如 ,要 选择 atmel 公司 的 89C51 芯片 ,可 在 Keywords 中 输入 8951, 则 在 Result 列表 中 
会 显示 所 有 名 称 中 含有 8951 的 元 件 ,用 户 选 择 所 需 的 一 款 元 件 即 可 。 如 图 5. 1. 4 所 示 。 





Keymcrds Bews (时 
16951 [ooice 区 jb 工 Descnphon 和 
Masch Whole Wands? | AT69C51 MC5S8051 6051 Muczocomalee 14kB code 33MHz Di6 Tmes .UnT) 


Showm on pallt wml modett? | AT99C51 BUS M[S9051 6051 Microcoricler |4kB code 33MHz 2xi6tba Tmes UART) 
| AT99C51R82 MC58051 “8051 Mrocoricke 11BkB code 40MHz Wakechdog Time 316b Tmers UART) 


Calegoy | ATBSC51RB2BUS MC58051 8051 Microccrioler 11EkB code, 4BMHz Watchdog Timet 3y16-ba Timets UART) 
ET 得 AT09C51hRC2 MC58051 8051 Microcorkole 1328 code.49MHz Waichdog Tinel. 3y16.bi Tinett UART) 
Microprocesscn ICs AT89C51RC2BUS5 MCS8051 8051 Microccricles |32B code. 48MHz Watchdog TimelL 3v16ba Tmes UART) 


ATB9CS1IRD2 MC58051 6051 Microcorioler i64B code 40MHz Waichdog Termeal 3y16-b Times UaRAT) 
ATB9C51RD2BUS MC5S6051 6051 Microccntcler I64B code. 40MHz Watchdog TimeL 3w16'-ba Times UART) 


图 $.1.4 元 件 筛选 


选择 好 元 件 后 单 击 OK 按钮 ,所 选 元 件 即 出 现在 左 侧 的 Devices 列表 中 ,并且 在 预览 窗口 


中 显示 该 元 件 的 预览 图 。 如 图 5. 1. 5 所 示 。 


其 他 元 件 可 用 同样 的 方法 添加 到 Devices 列表 中 。 本 例 需要 添加 的 元 件 , 如 图 5. 1. 6 所 示 。 








ICRYSTAL 
| 
| 
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RESPACK3 





图 5.1.5 元 件 预 览 图 5.1.6 本 例 所 需 元 件 列表 
:和 引 一 吕 
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(3) 元 件 选 择 完 毕 后 ,下 一 步 的 工作 是 摆 放 元 件 。 在 Device 列表 中 选择 一 款 元 件 , 例 如 
89C51, 并 在 绘图 区 单 击 ,出 现 一 个 红色 框图 ,用 户 可 将 其 调整 到 合适 位 置 再 次 单 击 , 摆 放 该 元 
件 , 如 图 5. 1.7 所 示 。 


下 目 
| 上 
| 三 
二 三 
| 全 
三 
二 冯 


图 5.1.7 添加 元 件 
用 户 可 按 同样 方法 将 其 他 元 件 摆 放 在 合适 的 位 置 。 需 要 注意 的 有 
是 , 某 些 元 件 的 默认 摆 放 方向 并 不 合适 ,可 以 使 用 窗口 左上 方 的 旋转 工 -FF 它 
具 栏 按钮 G 或 口 进行 调整 。 例 如 晶振 CRYSTAL 初始 为 水 平方 向 , 通 本 
过 旋转 工具 栏 按钮 将 其 调整 为 垂直 方向 ,如 图 5. 1. 8 所 示 。 图 5.1.8 元 件 方向 调整 
元 件 摆 放 如 图 5. 1. 9 所 示 。 
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除了 所 选 元 件 外 ,在 原理 图 中 一 般 还 需 用 到 电源 与 接地 等 终端 ,可 通过 模式 工具 栏 的 终端 
按钮 三 添加 。 单 击 按钮 三 后 ,在 Device 列表 中 列 出 了 所 有 可 用 终端 。 如 图 5. 1. 10 所 示 。 


TERMIMNALS 


-= 一 。- -=-enw-~ 一 wm 





图 5.1.10 终端 模块 
将 电源 POWER ,接地 GROUND 添加 到 绘图 区 域 中 合适 的 位 置 , 如 图 5.1. 11 所 示 。 
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图 5.1.11 添加 电源 与 接地 


(4) 元 件 添 加 到 绘图 区 后 ,双击 元 件 , 可 打开 元 件 编辑 窗口 ,如 图 5. 1. 12 显示 的 是 电容 
Cl] 的 编辑 窗口 。 


Edt ComPponent 
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图 5.1.12 元 件 属性 编辑 窗口 
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(5) 属性 设置 : 

Conponent Reference: 该 元 件 在 厚 理 图 中 的 编号 为 Cl 。 

Capacitance: 该 电容 的 电容 值 为 22pF。 

PCB Package: 该 元 件 的 封装 格式 为 CAP10。 

如 果 选 中 Hidden, 则 对 应 的 属性 就 不 会 在 原理 图 中 显示 。 配 置 完成 后 单 击 OK 按钮 确 
认 。 用 同样 的 方法 配置 C2 为 22pF,C3 为 10pPF,R1 为 10 kQ,RP1 为 2200,RV1 为 10 ko。 

(6) 元 件 摆 放 完毕 后 ,需要 进行 的 是 连 线 工 作 。 在 Proteus 中 可 以 很 方便 地 完成 走 线 , 它 
同时 支持 自动 与 手动 布线 ,用 户 只 需 选 择 起 点 和 终点 ,系统 会 自动 走出 一 条 合适 的 连 线 , 再 结 
合 手动 布线 可 以 达到 很 好 的 布线 效果 。 

例如 芯片 左 侧 的 晶振 电路 部 分 ,在 GROUND 的 引 脚 处 单 击 , 并 向 电容 C1 移动 ,系统 会 自 
动 走出 图 5. 1. 13 所 示 的 连 线 , 然 后 在 Cl 的 左 侧 引 脚 处 再 次 单 击 , 完 成 连 线 工作 。 

如 果 用 户 想 要 自 定 义 走 线 的 路 径 ,可 以 在 期 望 的 拐点 处 单 击 , 如 图 5. 1. 14 所 示 。 


C1 
IE 
CRYSTAL C1 
cC2 于 
本 | LT- 站 下 
R1 3 一 中 X1 
= CRYSTAL 
1 本 
个 C3 62 
-六 
10F 20pF 
图 5.1.13 自动 连 线 图 $.1.14 自 定义 连 线 


在 元 器 件 引 脚 数目 较 大 时 ,使 用 总 线 可 以 有 效 地 简化 原理 图 。 用 户 可 通过 按钮 由 添加 总 
线 ,总 线 的 放置 步骤 为 :在 期 望 的 总 线 起 始点 .期望 的 拐点 处 单 击 , 最 后 在 期 望 的 截止 点 双击 。 
如 图 5.1. 15 所 示 。 
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图 $.1.15 添加 总 线 ni 
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放置 总 线 后 ,可 将 引 脚 连接 到 总 线 上 。 需 要 注意 的 是 ,使 用 总 线 后 ,需要 为 连接 到 总 线 上 
的 连 线 添 加 标签 以 使 其 一 一 对 应 。 可 先 选 中 要 添加 标签 的 连 线 , 右 击 ,在 右键 菜单 中 选择 
Place Wire Label 即 可 添加 标签 ,如 图 5.1. 16 所 示 。 


Edt Label 
Delete Label 


中 Drag Wire 
Edit Wire Style 
愉 Delete Wire 





LEL place 
Show 上 | Wire Labels 

Hide 有 | Wire Labels 
办 Show net in Design Explorer 


了 Highlight net on Schematic 


图 $.1.16 添加 标签 菜单 
本 例 中 ,为 总 线 添 加 标签 LL0. ..7], 表 示 其 集成 了 LO 一 L7 这 8 条 连 线 。 然 后 为 连接 到 
总 线 上 的 连 线 分 别 添 加 标签 LO 一 L7 ,如 图 5. 1. 17 所 示 。 


LCD1 
LM016L 
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图 5$.1.17 添加 总 线 标签 


除 总 线 外 ,为 单个 引 脚 添 加 标签 同样 可 以 达到 代替 直接 连 线 ,简化 原理 图 的 效果 。 例 如 ,可 
通过 标签 将 LCD 的 4.5.6 号 引 脚 与 89C51 的 P2.0、P2.1、P2. 2 引 脚 相连 ,如 图 5. 1. 18 所 示 。 


1 .230 ， 
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图 5$.1.18 添加 单一 连 线 标签 
布线 完毕 后 的 原理 图 如 图 5. 1. 19 所 示 。 





心 人 水 
RP1 
人 X1 
一 性 
CRY 雪 U 
ca 一 
一 
2 一 全 王 | 
R1 及 
AN 瑟 -证 
10 KG 
人 小 C3 RESPACKS 
地 
如 PEF 





图 5$.1.19 布线 完毕 后 的 原理 图 
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s.1.3 PCB 制 板 


完成 原理 图 绘制 及 相关 属性 设置 后 , 单 击 按钮 奢 ,可 一 键 切换 到 ARESPCB 制 板 软件 ,对 
原理 图 进行 制 板 前 的 处 理工 作 。ARES 支持 自动 /手动 布局 .自动 /手动 布线 ,结合 其 内 部 集成 
的 大 量 元 器 件 封装 ,可 以 方便 地 由 原理 图 绘制 出 PCB 设计 图 ,并 且 能 够 输出 PCB 板 的 3D 
像 ,使 用 户 更 直观 地 看 到 可 能 存在 的 不 合理 布局 ,如 图 5. 1. 20 所 示 。 


竺 于 入 大 本 和 开关 癌 


站 国 二 和 人口 三 政 人 





s.1.20 PCB 图 绘制 界面 


(1) 在 布 板 前 ,首先 要 设置 板 的 边框 尺寸 ,选择 编辑 工具 栏 中 的 2D 和 拢 形 按钮 圈 , 并 在 板 层 
选择 栏 中 选择 Board Edge。 在 绘制 板 的 边框 前 ,还 需要 注意 工具 栏 上 的 mm 按钮 ,转换 英制 / 米 
制 单位 ,这 里 选择 米 制 单位 。 

完成 上 述 工作 后 , 按 O 键 , 定 位 坐标 原点 。 按 住 鼠 标 左 键 并 拖 动 ,下 方 的 状态 栏 会 显示 鼠 
标 指 针 当 前 所 在 的 坐标 ,在 合适 的 位 置 再 次 单 击 , 即 完成 边框 的 绘制 工作 。 本 例 中 绘制 一 个 
80X55 mm 的 矩形 框 , 如 图 5.1.21 所 示 。 
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图 5.1.21 绘制 边框 
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(2) 单 击 编辑 工具 栏 按钮 朱 ,元 件 列表 中 会 列 出 原理 图 中 所 用 到 的 所 有 元 件 , 并 在 预览 窗 
口中 显示 元 件 封装 格式 ,如 图 5. 1. 22 所 示 。 
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图 5.1.22 预览 元 件 封装 


本 例 中 所 用 元 件 较 少 ,因此 采用 手工 布局 。 首 先 单 击 工具 栏 中 的 按钮 及 ,将 绘图 区 调整 到 
合适 的 大 小 ,然后 依次 将 列表 中 的 元 件 摆 放 到 边框 之 内 ,如 图 5. 1. 23 所 示 。 





图 5$.1.23 手工 摆 放 元 件 


(3) 元 件 摆 放 完毕 后 ,利用 ARES 的 自动 布线 功能 可 以 快速 完成 布线 工作 ,必要 的 时 候 结 
合 手动 布线 ,可 以 得 到 一 个 令 人 满意 的 结果 。 


单 击 工具 栏 按钮 淘 , 弹 出 图 5. 1. 24 所 示 的 自动 布线 对 话 框 , 本 例 选 用 默认 设置 , 单 击 Be- 
gin Routing 按钮 ,开始 布线 (图 5. 1. 25) 。 


233。 


国 : 基于 模型 的 设计 一 一 MCU 篇 


上 wecubon Mode 
昌 站 un Da hedho somasbcaiy 
| Epox Deson Fl 


| Impot 5esoon Fi 


Run specied 00 eulomsbcely 


Eme rouiel commands inierscevely 


Deswgn Ruies- orgicl Handino 
weBidt jh Tieel congcts as misangs RD 
Visg 丰 5 十 Losd conficts ss BegMbacks 
low oll outng7 Megal kscks mi hash yeiow sand 
- 动 者 上 deso0n rue volehons 





图 S$.1.24 自动 布线 对 话 框 图 $.1.25 完成 自动 布线 


(4) 布线 完成 后 ,下 一 步 的 工作 是 铺 铜 。 在 编辑 工具 栏 中 选择 按钮 置 ,绘制 出 一 个 不 超出 
边框 的 矩形 ,绘制 方法 与 边框 相同 。 绘 制 完成 后 会 弹出 图 5. 1. 26 所 示 的 对 话 框 ,在 Net 下 拉 
菜单 中 选择 VCC/VVDD=POWER ,在 Layer/Colour 下 拉 菜 单 中 选择 Top Copper, 单 击 OK 
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图 5.1.26 铺 铜 对 话 框 


重复 上 面 的 步骤 ,并 在 Net 下 拉 菜 单 中 选择 GND 王 POWER, 在 Layer/Colour 下 拉 菜 单 
中 选择 Buttom Copper, 单 击 OK 按钮 确认 ,完成 底层 的 铺 铜 。 如 图 5. 1. 27 所 示 。 





图 5.1.27 底层 铺 铜 
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(5) 完成 上 述 步骤 后 ,PCB 制 板 就 基本 完成 了 ,通过 ARES 提供 的 3D Visualization 功能 
可 以 直接 看 到 制 板 后 的 效果 图 ,判断 元 件 布局 是 否 合理 。 

在 菜单 中 选择 Out put-~>3D Visualization 即 可 得 到 图 5. 1. 28 所 示 的 3D 效果 图 。 用 鼠标 
或 方向 键 可 以 调节 多 种 视角 进行 观察 ,如 图 5.1. 29 所 示 。， 





图 $.1.29 PCB 三 维 视图 (二 ) 


S.2 Keil CS1 集成 开发 环境 (IDE) 


sS.2.1 预备 知识 


1，Keil CS1 IDE 的 使 用 


Keil C51 是 一 款 有 效 的 符 人 式 软 件 开发 平台 , 它 兼容 C 语言 和 汇编 语言 ,在 国内 应 用 相 
当 广泛 ,并 且 Keil C51 可 与 Proteus 无 缝 连接 ,实现 虚拟 硬件 测试 ,节省 开发 成 本 ,提高 开发 效 
率 。 下 面 将 建立 一 个 Keil C51 工程 ,驱动 5.1. 2 小 节 建 立 的 LCD 电路 。 

(1) 选择 菜单 Project->New Project ,在 对 话 框 中 为 工程 指定 保存 路 径 、 名 称 , 如 图 5.2.1 
所 示 。 


xs 


加- 基于 模型 的 设计 一 一 MCU 篇 


和 Create New 0 


7 
本 攻 尝 本 地 于 笃 (Di 二 ke 计 les 》 te 惑 


人 


文件 们 [IN)}; 3 


保存 类 琵 (T): project Flles (*.uvproj) 


| - 浏览 文件 交 [B) 





5s.2.1 新 建 工程 


(2) 保存 该 新 建 工 程 后 ,弹出 Select Device for Target“Target 1 对话 框 ,在 左 侧 列表 杠 
中 选择 Atmel 中 的 AT89C51 芯片 ,如 图 5.2. 2 所 示 。 


Vandor ”Amel 

Deyice: AT89C51 厂 Use Edended Unker (LX51jinstead of BL51 
Tooclset CC51 伍 Fi 
Data base Description : 


TESTSND3 | [sibassdF SCZNHICMOSCoOSrwih32 10Ues 
下 AT8 下 51 |2 TimersyCounters. 6 Interupts/2 Piority Levele.UART 

外 AT8T51RC 广 司 1 4K Bytes Hash Memory， 

四 XpagFEz 128 Bytes On-chip RAM 

名 AT8 下 55WD 
八 AT89C1051 
名 AT83C10510 
名 AT859C2051 
自 AT89C4051 
自 
图 AT89C5115 
四 AT89C5130 
名 AT89C5130A 





图 5.2.2 选择 芯片 


(3) 选择 芯片 并 确认 后 ,系统 会 提示 是 否 将 Startup Code 复制 到 工程 文件 淆 中 ,选择 
“是 ”, 如 图 5. 2. 3 所 示 。 


bVision 2 忆 


Kopy Standard 8051 Startup Code to Project folder and Add Flle 
to Project ? 





图 5.2.3 Startup Code 复制 信息 
(4) 工程 建立 完毕 后 ,需要 将 源 文件 添加 到 工程 中 。 在 Keil 界面 左 侧 的 Project 区 域 , 右 
击 Srouce Group1l ,选择 Add Files to“Source Group 1 ,如 图 5. 2.4 所 示 。 
在 弹出 对 话 框 中 ,选择 源 文件 test. c, 如 图 5. 2.5 所 示 。 


| 


玫 
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[党 Targett Ri 





一 3 人 | 2 二 有 


必 options for Group 5ouree Ca At-F7 


夯 Rebuild alltarget files 


元 Build target 主 


直人 


p build 


Adad Group.- 


Add Files to Group 'Source Group 工 -. 


Remoxye Group Source Groupl andgd ts Pie5 
和 Manage CompPponments.， 


4 】 Show 1 生 Pmnnnninnn Fe so 


图 $.2.4 添加 代码 菜单 


源 文 件 内 容 如 下 : 


间 include < reg51.h 一 
井 define uchar unsigned char 
# define uint unsigned int 


uchar code tl[] = "drived by 8051 "; 


uchar code t2[ ] =" processor1 "; 
Sbit RS = P2”0; 
Sbit RW = P2“1} 
Sbit 卫 = P2~2 ; 
void delay(uint x) 
{ uchar Yi 

While(Cx 一 一 ) 

{ 

for(Y=0;iyY<1005Y++ ); 


} 
Volid write_command(Cuchar cmd) 


{ RS = 0 


delay(1); 

了 BE= 0; 
} 
Volid write _data(uchar dat) 
{ RS = 1; 

RW = 0; 





图 5.2.5 选择 源 文件 


//LCD 命令 写 人 琐 数 


// 数 据 写 人 函数 





修改 日 其 
2010/8/4 21:46 


// 定 义 LCD 显示 的 字符 


沁 基于 模型 的 设计 一 一 MCDU 篇 


了 = 0; 
BQ = dati; 
了 = 1; 
delay(1); 
E = 0 

} 

void initialize() //LCD 初始 化 函数 

{ write_command(0x38) ; 
delaVy(1) ; 
write_command(Dx01) 
delay(1); 
NEite_Command(0x06) ; 
delay(1); 
wT ite_Command(Ox0f) ; 
delay(C1); 

} 

void main() 

{ uint il 
initialize(C); 


write commnand(0Ox81); // 显 示 第 一 行 字符 ”drived by 8051?” 


for(i=0;ii<l4;i+ +)》 

{ write data(tl[ij); 
delavy(200) ; 

} 


write _command(0x80 + 0x40 + 0x03); // 显 示 第 二 行 字符 " processor! 


for(i=0;ii<losi+ +) 

{ write data(t2[i]); 
delaV(200) 

} 

While(l); 


(5) 文件 添加 成 功 后 , 单 击 界面 上 方 工具 按钮 太 , 进 行 简单 配置 。 


在 Target 面板 中 ,将 晶振 频率 设置 为 12MHz。 但 如 果 是 硬件 ,此 处 不 需 修改 ,程序 会 以 


硬件 实际 频率 运行 ,如 图 5. 2.6 所 示 。 


和 mel ATBSC51 
Xal (MHz |12 厂 Use Onchp ROM (DOx0-OxFFP 
Memory Mode [Snaa Variables mn DATA | 
Code Rom Soze Ju 64K progam ~] 
Operahng sysxem [hene *] 


图 5$.2.6 设置 晶振 频率 


在 Outpnuit 面板 中 选中 Create HEX File, 在 编译 时 将 生成 HEX 文件 ,可 以 在 Proteus 中 
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仿真 ,也 可 以 下 载 到 硬件 中 运行 ,如 图 5. 2.7 所 示 。 


| 全 Ceale Executable，Nted | 
芭 7 Debog Information 忆 Browse Infomnation 


克 Create HEX Rle HEX Fomat: [HEX-80 | 


| CCeae LUbray- MesUB 厂 Ceae Bach Rie 


图 5$.2.7 设置 输出 文件 格式 
(6) 配置 完成 后 , 单 击 快捷 按钮 这 开始 编译 并 连接 工程 ,如 图 5.2. 8 所 示 。 


ETIERRCRTTTCDDD 天 三 ) 





凤 test - bVision4 
















Ble Ed Wew projed Fash Debug petpherakg Ioos Svc5S window Help 


Po 昌 
| 咬 六 归 让 六 国 下 上 候 ， 只 | 
: 史 国 帅 辣 需 : 害 LUrmeet : * 并 昌 码 | 


sd 站 is 
因 TEsrc | 了 X|| 
0I 门 +include<zeg51 .hb> 
02 | zaefine Ucnhaz Unsignped chaz 

03 #deEine inc unsiogned In 

04 | uchaz code zilj=ndzived by 85053”"; 
05 | achaz code z2[]="Pzoces3DZ1n 7 















日 33 Target 1 
已 Source Group 1 
国 STARTUPA51 
二 因 testc 
| 下] projed | 伟 5ooks |{) Fundi.|0wTempt 














Bidla 二 arget -Target 工 
assemrmbling STARTUP .A51. .。 
ComplIling 七 est.C..。 | 
1inking..。. 

Program Size: data=11.0 xdqata=0 code=220 
creating hex file from "test"..。 
rtestn -0 Errorts)，0 Warningd(s) . 





图 5.2.8 编译 工程 


2。Keil CS1 与 Proteus 的 联 调 


安装 Keil C51 V9.01 版 与 Proteus 7.7 版 后 ,还 需要 进行 简单 的 配置 才能 将 其 整合 。 

(1) 打开 proteus 安装 目录 的 帮助 文件 均 , 如 x:N\Program Files\Labcenter 下 lectronics\ 
Proteus 7 Professional\HELP ,找到 帮助 文件 ARM. HLP, 在 首页 单 击 链接 Remote Debugger 
Drivers( 图 5.2.9) 。 

在 Remote Debugger Drivers 界面 ,选择 链接 Download and Install remote debugger driv- 
er for Keil uVision3( 图 5. 2. 10) 。 

随后 将 联 调 插件 vdmagdi. exe, 保 存在 本 地 磁盘 (图 5. 2. 11) 。 

(2) 运行 vdmagdi. exe 后 ,按照 安装 向 导 一 步 步 完成 安装 ,如 图 5. 2. 12 一 图 5. 2. 16 所 示 。 





The ARM7TDMI core model simulates the ARNMD7TDMI and ARM7TDMIS microprocesS0Or CO018 
from Advanced RISC Machinss (上 RM Lidl This model is Perimaniy intended for Use 55 3 fodellng 


| 

| Primnilve within fdels of 5SD0CNC dewces such 35 the PCOO0OD 52roS bt could 到 So be relevarg 
| imaeducational context of whare U5es Wiuch to sirmulate an ARM7 core in conyunction Wi 人 
elsernants of 3n SoC deSign In tis Situation the additional elerments could be maodelled using the 
VSM SDK to create additional DLL mode 结 


园 ”Direct use of the ARMT7TDMI core within User deslgns 访 for the very experienced designers only - 
羡 theflexiolity and complexiky of the pipehned bus architecture maka the mterfacing of mmemory and 列 
other Penpherals into 3 yery COmPlex 13SK | 


7 站 


和 
总 


LeteckR ERRA 
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control the debugging 5655Ion room just 35 YOU would when debugging real physical hardware 
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昌 1 
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图 $. 2. 10 Remote Debugger Drivers 界面 


| Setup Labcenter Electromics Proteus VSM AGDI Drivervi10 2 









[| Welcome lo the lnstagshueld Wizeard ior Proteus 
VSM AGDI Diiver v1.0 


The inatsISheldd7wRand will netal Labceriel Escuorvce 
Proteus VSMAEDI Drve v10on you compuier To 
CO cck Ned 





3 While iiesfrom the Intemet Can be UsefUi thisfie type can 
和 potertaly harm YOUr Computer 重 You do nat tnudt the SOUrce .do not 


run of SavVe this Sohware Wheathensk7 








图 5$.2.11 保存 联 调 插件 图 5.2.12 安装 起 始 界面 
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Serup Labcemter Electromcs Proteus VSM AGDi Driverv10 LE 


后 ”| secup Labcenter tlecronics proteus VSM AGDiDrivervi10 
附 | Choose Destination Location 筷 就 
下 Selecy loldel vdhere Setup wdl ratol hies 


Seup willinslaijLabcermer Elscyormics ProleusVSM AG6DI Driver v1.0n he loliowng 
folder 


| Setup Labcemter Electromics Proteus YSM AGDI Derver v10 


Setup Type 
Choose 小 e Selup pe 由 at be3l SuUits OUI needs 





Cick 路 e ype of Setup OU prefer 1 | 
MEDIDREEEEGG 一 人 人 人 Descipion 必 | 

InsalAGDI Dmversior Kell | | To nslal io ihis icidert. cECk Ne Toinaalios dilemen folder click Browse and sclec 
wiion 3196051 andARM) anclher ioldes 





| When you press Nesd. fle uansie wa begn 


Deshrnahon Fokder 


cwi _emm- ji | 


<kBack | Nety | Cancal 日 kBack | _ Net | Cancal | | 





on 





图 5.2.13 选择 Keil 版 本 图 $.2.14 选择 路 径 


在 组 件 选 择 对 话 框 中 同时 选中 8051 AGDI Driver 和 ARM AGDI Driver, 以便 ARM 工程 
也 可 以 和 Proteus 进行 联 调 (图 5. 2. 15) 。 
安装 成 功 如 图 5. 2. 16 所 示 。 
| ep bbeenier BeeronispeteusYSMAGDIDier0 。。 。。 。。。 国 本 。 | Sevp bbeenter gecronicsproteos VsMAGDIDrrer 10 
Select Componenits | 


Choose lhe components Setup wd mn 引 o 1nstallShiekd Wizard Complete 





Sekup has hmashed installrg Labcerie Eliecuorncs Proteus 
VSM AGDI Drves v1.0 on you computer 


Selecl 由 o components ?0Ou wart io mstal cjeur the components you do not want io mstal 


| 





机 RRMEAGDiDiverDMARN DLL 
6051 A6DI Drver MDMS51DLL) 





Deshneton Folder 
| 
| 





D 全 四 ”Browse | 
Space Requred on D 3956 大 人 
Space Available on D 89707848K ciuvde -ost 玫 
f - | 汪 
| 《Back | Ne》 Cancal | Frtth | 
L me we it 
本 -232 } 人 











图 S$.2.15 组 件 选 择 图 5$.2.16 安装 完成 


(3) 打开 第 5. 1 节 完 成 的 Proteus 原理 图 ,在 菜单 栏 中 选择 Debug 一 Use Remote Debug 
Monitor。 如 图 5. 2. 17 所 示 。 ER 


扩 | StarwRestart Debugging CtdsFl2 


帮 Execute 得 
Evec<ute Waijhowt Breakpcintg ARvFl2 
Execute for Specifed Time 


Reset PopuP Wendows 
Retet Perciyviernt cdel Dar3 
对 Corfgure Diasgnostics- 


“ITDTTTRTTTTTTIEES 


图 5.2.17 启用 远程 调试 9 
过 “241I 四 


本 基于 模型 的 设计 一 一 MCU 篇 


(4) 打开 上 文中 建立 的 Keil 工程 , 单 击 界面 上 方 工 具 按 钮 太 , 在 Debug 选项 卡 中 选择 使 
用 Proteus 仿真 器 ,如 图 5. 2. 18 所 示 。 


Device | Target | Output | Listing | User | C51 | AS1 | BL51 Locate BL51 有 isc Debug Utilities 


人 Use Simulator Setings | 人 Use: [poleus VSM Smulator =] Setings 


| 
厂 mi Speedto ReaFTme 


1 和 adgatase 了 ea 


Infineon XC800 ULINK Drver 
站 Di Monitor Drver 

Re Irfineon DAS Chient for XC800 
9 下 ULINK De 





图 5.2.18 选择 Proteus 仿真 器 


至 此 ,Keil 和 Proteus 已 经 完成 了 整合 ,可 以 实现 联 调 功能 了 。 在 Keil 中 单 击 按钮 贸 开 始 
调试 。 如 图 5.2. 19 所 示 。 
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ee 1 下 1 二 
me 站 2 Eee RNEY 1 CO 站 -一 : wa 
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图 5.2. 19 Keil 调试 界面 


单 击 全 速 运行 按钮 妃 ,Proteus 中 的 原理 图 会 同步 显示 运行 结果 ,如 图 5. 2. 20 所 示 。 
除了 全 速 运行 按钮 怒 外 ,调试 环境 下 还 提供 了 : 

@ 入 程 序 复位 。 

@ @@ 停 止 全 速 运行 。 

@ 妇 进 和 信子 函数 。 

曲 胖 单 步 运行 。 

@ 和 跳出 子 函 数 体 。 

@) 妊 运 行 至 光标 所 在 行 。 


站 吕 
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图 5. 2. 20 “Proteus 运行 结果 


在 调试 模式 中 利用 以 上 功能 按钮 ,可 以 实现 单 步 、 全 速 . 断 点 调试 。 

设置 断 点 :调试 过 程 中 ,用 户 有 时 能 确定 错误 在 程序 中 大 概 的 位 置 ,可 以 通过 设置 断 点 ,将 
程序 快速 运行 到 关键 位 置 。 

在 期 望 设置 断 点 的 程序 行 序号 左 侧 双击 , 即 可 设置 断 点 。 当 单 击 全 速 运行 按钮 后 ,程序 将 
迅速 定位 到 断 点 所 在 位 置 ,如 图 5. 2. 21 所 示 。 
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图 5.2.21 设置 断 点 


， 恒 基于 模型 的 设计 一 MCU 篇 


观察 变量 的 值 :对 于 一 些 重要 的 变量 ,需要 一 直 关 注 其 变化 。 单 击 右 下 方 的 watchl 子 选 
项 卡 ,在 Name 区 域 下 方 双 击 或 按 F2 键 , 即 可 设置 需要 观察 的 变量 。 例 如 ,输入 程序 中 的 变量 
i, 如 图 5. 2. 22 所 示 。 


hm bo | 
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图 5.2.22 观察 变量 值 


观察 IVO 口 的 值 : 对 于 本 例 的 单片机 实验 ,P0O 口 的 电 平 决定 了 LCD 上 的 显示 结果 ,通过 
菜单 栏 上 的 Peripherals~I/O 一 Ports 一 Port 0 可 以 调 出 Po 口 状态 ,如 图 5. 2. 23 所 示 。 
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图 5.2.23 观察 VO 接口 值 


在 Proteus 界面 中 ,同样 提供 了 观察 芯片 寄存 器 的 工具 。 在 单 步 调试 时 , 右 击 AT89C51 
芯片 ,选择 8051 CPU 子 菜单 ,可 以 看 到 , Registers Internal(IDATA)Memory、SFR Memory 
子 项 ,选中 任意 一 个 即 可 显示 相应 存储 器 的 内 部 数据 ， 如 图 5. 2. 24 所 示 。 

例如 选择 Registers, 弹 出 图 5. 2. 25 所 示 的 窗口 ,可 以 看 到 当前 机 器 指令 及 各 寄存 器 的 
数值 。 

若 选择 SFR Memory, 则 弹出 图 5. 2. 26 所 示 的 窗口 ,该 窗口 中 的 值 是 与 实际 物理 地 址 相 
对 应 的 。 例 如 P1 对 应 的 实际 物理 地 址 为 0x90( 具 体 可 查看 8051 头 文件 ) ,其 中 的 数据 为 FF， 
与 Registers 窗口 的 值 相符 。 发 生变 化 的 值 以 高 亮 形式 表示 。 
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一 他 做 Display Datasheet Ctrl+D 


了 而 人 国 Show in Design Explorer 
呈 
-PT7 | 印 Show Package Allocation 


上 TSGC4 宙 Operating point Info 


这 Make Device 


扼 ' packaging Tool 


Internal 0DATA) Memory - Ul | 
SFR Memory - UI | 


图 5.2.24 805S1CPU 芯片 菜单 


8051 CPU Registers -Ul ”| 呵 


PC INSTRUCTION 
DO0A3，S]JMP 009C 


AKCC B DPTR SP CA-rSO-P 
DO 00 00A6 05 10000001 


人 


8051 CPU SFR Memory - UI 四 


PO PT P2 P3- SCON- 58UF 
64 FF F9 FF 

TMRO TMRI TMOD TCON PCON 
0000 0000 00 00 00 00 00|00 00 00 00 


半生 
09 00 ;00 00 00 00 
00 00 00 





IE 工 己 TMR2 TCON RCAP 
00 00 0000 -00 ”0000 


图 5.2.25 寄存 器 观察 窗 图 5.2.26 SFR 存储 器 观察 窗 


s.2.2 RTW-EC 快速 代码 生成 


Real-Time Workshop Embedde Coder(RTW-EC) 是 Real-Time Workshop(RTW) 自 动 代 
码 生 成 工具 的 扩展 , 它 加 入 了 多 种 对 于 敌人 式 软 件 开 发 至 关 重 要 的 功能 。 用 户 使 用 RTW- 
EC, 可 以 得 到 清晰 、 紧 次 、 高 效 、 接 近 专 家 手写 的 C 代码 ,这 对 于 骨 人 式 系统 或 大 型 设备 的 实时 
仿真 .快速 原型 建立 是 相当 必要 的 ,还 可 以 自行 定义 生成 代码 的 形式 ,针对 特定 的 目标 环境 进 
行 代码 优化 ,继承 或 集成 现 有 的 函数 与 数据 ,建立 代码 与 模块 之 间 的 关联 ,进行 代码 验证 。 其 
主要 特点 如 下 : 

(1) 从 Simulink 和 Stateflow 模型 中 生成 ANSI/ZISO C 和 C 十 十 代码 及 其 可 执行 文件 , 生 
成 的 代码 在 内 存 占 用 率 .运行 速度 及 可 读 性 等 方面 可 同 手 写 代 码 相 媲美 。 

(2) 扩展 了 Real-Time Workshop 和 Stateflow Coder, 其 在 产品 实现 方面 具有 最 优化 及 
代码 配置 等 特点 。 

(3) 支持 所 有 Simulink 数据 对 象 和 数据 字典 功能 ,包括 用 户 定 义 的 存储 类 类 型 及 别名 。 
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(4) 提供 目标 函数 库 代 码 的 定制 ,从 而 为 特定 处 理 器 生成 机 器 代码 。 

(5) 无 论 有 无 RTOS, 均 可 对 多 速率 代码 进行 简明 分 割 以 提高 运行 效率 。 

(6) 包含 可 扩展 的 模块 封装 特性 和 自 定义 数据 对 象 。 

《7) 提供 详尽 的 注释 ,并 使 用 超 链接 进行 代码 到 模型 和 需求 之 间 的 双向 跟踪 。 

(8) 自动 将 生成 的 代码 导入 Simulink 进行 软件 环 路 测试 ,从 而 对 代码 进行 验证 。 

(9) 使 用 Simulink 报告 生成 功能 在 Simulink Model Explorer 中 生成 代码 帮助 文件 并 以 
此 作为 独立 的 报告 。 


1. 代码 生成 原理 


作为 预备 知识 ,这 里 简要 列 出 RTW-EC 生成 代码 的 原理 及 各 代码 文件 的 意义 ,读者 宜 在 
完整 阅读 了 后 续 各 节 并 实际 操作 ,有 了 感性 认识 后 ,再 返回 理解 本 小 节 。 关 于 RTW-EC 更 详 
细 的 说 明 ,请 参考 帮助 文档 。 





se 图 5.2.27 是 TLC 目标 语言 编译 器 与 RTW 代码 
生成 器 生成 C 代码 的 过 程 。 首 先 ,RTW 将 Simulink 
4 模型 生成 对 应 的 RTW 文件 ,该 文件 包括 了 生成 代码 
“tc test.rtw 所 需要 的 信息 ,这 些 信 息 应 由 用 户 在 建 模 时 指定 。 然 
ET _ 后 TLC 编译 器 读 取 RTW 文件 , 据 此 选择 系统 TLC 
Target Language Compiler| 和 模块 工 LC 文件 ,进而 生成 C 源 文 件 . 头 文件 .MK 文 
sg 件 ( 用 于 生成 可 执行 文件 ) 等 。 生 成 的 文件 保存 在 与 模 
] 作 sw 型 同 目录 下 的 文件 夹 model_target_rtw 里 ,名 称 中 的 
mm model 代表 实际 的 模型 名 ,target 代表 目标 环境 (实际 

图 5.2.27 C 代码 生成 过 程 操作 时 可 能 是 ert、grt 等 ) 。 

2. 建 模 及 代码 生成 


图 5. 2. 28 是 一 个 简单 的 放大 模型 ,模型 名 为 test. mdl。 


in1 [ Out1 


Gain 
图 $.2.28 放大 模型 test, mdl 


选择 模型 主 窗口 的 菜单 项 Simulation-~>Configuration Parameters… (图 5. 2. 29) ,打开 模 
型 参数 对 话 框 ( 图 5. 2. 30) 。 


iop 
Conrfigurstion Pararneters 关 Ci+E 


Y _ Normal 
二 CCelerator 
Rapsd Accejerator 
Software-im-the-Loocp {SIU) 
Processor-in-the-Loop (PHL) 
Edtermel 





[Show the active corfiguration pararneters dialog，_ 1253% FocedStepDiscrete 


本 图 5.2.29 模型 窗口 
”RE 各 
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Select: Srmulatiofr brne 


starttme: 00 stop tme: 0 
广 Data ImporwWExport 
| Optimization 5oiver opbons 
=- Diagnostlcs 
六 Sample Time Type: .Fixedstep 了 Sover: |d5crete (no Continuous Ste5) .2327 
三 Date Validity Fixsd-sep SZe [fundasmentai sample time): 0.01 
广 了 pe Conyerson 
Conmectwity 
| | Compatbity 人 5ng and Smple time option5 
| Model Referencing Periodic 5ammple jime constraint: Unconstrained | 
| -Saving | er 人 人 < ev re ce -> rm、 +oeeamersrronr-cen 一 一 下- 
| 
| LSstatefiow Tasking mode for perodK Smmgle Wirmes: Auto 下 | 
| 上 Hardware Implermentanon Autpmatically handie rate ansltion for data transier 


| 广 Model Referencmag 
Slimulaton Target 
| | 上 Symbols 


傅 不 


Higher priorlty value indicates higher 基 革 prionlty 


图 5.2.30 参数 设置 对 话 框 


在 Solver 面板 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01( 图 5.2. 31) 。 
Real-Time Workshop 面板 ,设置 TLC 文件 为 ert. tlc( 图 5.2. 32) 。 


Target selection 





Eggs System target 侧 e: ert.tic Browse..， 
Type: | Fixed-step ”|; Solver: discrete (no continuous states) assaaainaregiemipapSwanyeaaaeem 
Language:; 三 | 
Fixed-step size (fundamental sample time): 0.01 4 2 
Description; Real-Time Workshop Embedded Coder 
图 5.2.31 选择 求解 器 图 5.2.32 选择 TLC 文件 


Real-Time Workshop-~Report 面板 , 勾 选 所 有 复 选 框 , 便 于 后 期 检查 及 跟踪 (图 5. 2. 33) 。 


yi Create code generation report v Launch report automatically 
Navigation 


YY Code-to-model 


orrn 一 一 一 or 


Traceability Report Contents 
局 Eliminated virtual blocks 
以 Traceable Simulink blocks 
v| Traceable Stateflovv objects 


Traceable Embedded MATLAB functions 


图 5.2.33 报告 生成 设置 
单 击 模型 工具 栏 的 按钮 没 :( 图 5. 2. 34) ,生成 代码 ,报告 如 图 5. 2. 35 所 示 。 


Elle Edt Wiew Simulation Fermat ITools Help 


口 | 咏 加 马 Fr 人 > 二 | ，* 5 一 


incremental build 人 


图 $.2.34 生成 代码 


二 二 
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7 1 
SummarY 
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FF 天 天 站 
由 5ystem Repo 革 站 includae <stdao. rw 15 ef 再 GT TSR 
code IJnterface Report 未 ?include “ 飞 et。ii” / 汪 囊 DUe 了 了 末 态 pe TI | 
Tr bility R t 2 ?inclde 2twt7ypes hh CN 六 DPKXS PPS mW/ 
下 
Generated Files SCTAEImE PT OneStfeF IT 有 YEPEPF~YIRE CCCD Di 19EEPTD 人 
[-] Majin 有 le 上 15 hi6f Ere5 the 了 emerafed fed “Yeol-fime ， ee TinctrIcr 
二 再 JI TSDODIafeI PE 六 人 he ps jafe OF the pdae Suiprati 
srt_InainE - 。 0 
oa 二 站 六 态 a56 rafe ro 1n5 了 de 1 SeoperateD codeo。 王 DagDiner 


[-] Model flles Iferrepts 5ng 7IoasfIng PoIzTf Comtexr SFPETCheS 5re faret 5 
as 


EapIe Core IndIcato5 epe es 50UU 5 王 5 天] 5ce TOJI58I 
Ph 


南 
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tesSt.c En 
了 区 


siafeT 5oade Sap mnPfiet 吕 EFE CD 方 SIOT SG 
test ”CO npPiostipT PPede， 劝 35 ampjie 57apdrr 5ef5 避 J BFIDTr 
test_privateh YESLfINP 贡 DC En TetrnDi 了 05 Pt OresfeP， 
隔 。 
test typesh void zt_OneStep (woid) ， 
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static boolaear 了 DvaerxrtFlag = 0; 





[-] Utility 有 Iles 
rwtyYpes. 小 


TS 二 De TIEDPFEDPES 方 9 者 


图 5.2.35 代码 报告 


3. 代码 文件 分 析 


读者 根据 报告 上 的 文件 分 类 ,大致 能 了 解 这 些 代 码 的 功能 。 而 对 于 不 同 的 求解 器 .不 同 的 
TLC 文件 (如 第 8 章 ) 以 及 模型 的 其 他 优化 设置 ,生成 的 代码 则 不 尽 相 同 ,但 整体 的 代码 文件 
结构 不 会 有 太 大 差异 。 因 此 本 节 以 定 步 长 离散 求解 器 与 ert, tlc 为 基础 ,说 明代 码 的 意义 ,其 
中 各 文件 名 中 的 model 即 表示 模型 名 。 

(1) ert_main. c。ert_main. c 只 是 一 个 样板 文件 ,虽然 它 包 含 了 C 语言 最 主要 的 main 天 
数 , 并 在 main 果 数 中 调用 了 model_initialize .model_step .model_terminate 等 模型 洒 数 ,但 除 
此 之 外 并 没有 进行 其 他 更 多 的 操作 。 因 此 多 数 情 况 下 ,用 户 应 根据 实际 需要 在 ert_main. c 中 
添加 必要 的 与 硬件 有 关 的 代码 ,例如 头 文件 ,中断 服务 程序 .硬件 初始 化 代码 .算法 与 硬件 接口 
代码 .循环 语句 等 。 当 然 用 户 也 可 以 自行 编写 一 个 main. c 文件 ,调用 各 模型 函数 。 

(2) model. c。 该 文件 包含 了 模型 范 数 model _initialize .model _step .model_terminate 的 
入口 地 址 及 其 代码 ,这 些 代码 实现 了 整个 模型 的 算法 ,其 中 函数 model_step 实现 了 模型 中 所 
有 模块 的 功能 。 

本 例 的 test_step 函数 实现 了 输入 In .增益 .输出 Out 三 个 模块 的 功能 。 

(3) model. h。 该 文件 声明 了 模型 的 数据 结构 以 及 模型 输入 与 数据 结构 间 的 全 局 接口 ,并 
将 模型 图 数 model initialize model _step model _terminate 声明 为 外 部 函数 。model, ec 与 
model_data.c 将 引用 该 头 文件 。 

(4) model_private. h。 该 文件 包含 了 模型 与 子 系统 需要 用 到 的 本 地 宏 与 本 地 数据 ,如 果 
模型 中 含有 输入 自 外 部 模块 的 信号 , 则 该 文件 还 将 体现 这 些 信 号 的 配置 常量 与 声明 ,model. c 
与 model_data. c 将 引用 该 头 文件 。 

(5) model_types. h。 该 文件 提供 了 实时 模型 数据 结构 与 参数 结构 的 前 向 声明 ,可 重用 郴 
数 的 函数 声明 可 能 需要 这 些 声明 ,同时 该 文件 也 定义 了 用 户 在 模型 里 自 定 义 的 类 型 ,model. c 
将 引用 该 头 文件 。 
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(6) model_data. c。 该 文件 声明 了 参数 数据 结构 .常数 模块 数据 结构 以 及 模型 中 所 有 和 零 
值 表示 的 数据 类 型 。 不 过 如 果 模 型 没 用 到 这 些 数据 类 型 与 零 值 表示 , 则 不 生成 该 文件 。 

模型 test. mdl 含有 一 个 带 参 数 的 增益 模块 ,因此 test_data. c 包含 了 该 增益 模块 的 参数 : 
放大 倍数 ,model.c 将 引用 该 头 文件 。 

(7) rtwtypes.h。 该 文件 定义 了 由 RTW-EC 生成 代码 所 用 到 的 数据 类 型 .结构 体 与 宏 ， 
所 有 有 用 到 这 些 数 据 类 型 的 文件 ,都 应 引用 该 头 文件 。 

上 述 几 个 文件 之 间 的 引用 关系 ,可 以 用 图 5. 2. 36 表示 ,图 中 箭头 指向 的 文件 引用 了 箭头 
源 的 文件 。 






NEES 
Se、 


图 $.2.36 文件 引用 关系 


在 模型 参数 设置 对 话 框 的 Real-Time Workshop 一 Templates 页 面 ,选项 Generate an ex- 
ample main program 可 控制 是 否 生 成 ert_main. c 文件 ,默认 情况 选中 (图 5. 2. 37) 。 


Code templates 






Source 利 e (*.c) template: ert_code_tempiate.cet Browse… | | Edit... 
Header 利 e (<“.h) template: ert_code_termplate.cqt Browse... | Edt... 
Data termplates 

Source fle (=.c) template: ert_ code_template.c9t Browse.… | Edit 
Header fje (<*.h) template: ert_code_template.c9t Browse... | | Edit..， 
custom templates 


File custormization template: example_file_process,tlc | Browse,.. | | Edit， | 


Y Generate an examplie main program 


Target operating System: BareBoardExample 下 


图 5.2.37 选择 是 否 生 成 ert_main. ec 文件 


在 模型 参数 设置 对 话 框 的 Real-Time Workshop 一 Code Placement 页 面 , 选 项 File pack- 
ageing format 可 控制 其 余 文 件 的 生成 情况 (图 5. 2. 38) , 表 5. 2. 1 列 出 了 不 同 格式 时 代码 文件 
的 生成 情况 。 


Code Packaging 









File packaging format; [Modular 
Compact fwith separate data f 介 le) 
conmpadt 





和 
mpaeapemeaapeemgemeeemeeam 昂 





图 $.2.38 选择 生成 代码 的 形式 


.249 ， 
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表 5$. 2.1 


File Packaging Format 


生成 的 文件 






model. c 






model. h 


model types. h 






Modular (default) 






model _private, h 

model data. c《 非 必需 ) 
子 系统 文 件 ( 非 必需 ) 
model.c 

model. h 

model data. c( 非 必需 ) 


model.c 
model. h 






Compact 


(with separate data file) 


Compact 


不 同 格式 的 代码 生成 情况 


移 除 的 文件 


model_private, h 


model_ types. h 


model _ data.c 
model_private. h 


model types, 


表 5.2.1 列 出 了 代码 生成 时 被 移 除 的 文件 ,但 并 不 表示 它们 所 实现 的 功能 也 被 移 除 了 ， 
RTW-EC 在 生成 代码 时 将 这 些 功 能 整合 进 了 model, c 或 model.h, 如 表 5. 2. 2 所 列 。 


表 S$.2.2 移 除 与 移入 文件 的 关系 


移 除 的 文件 
model _private. h 
model_types. h 


rmodel_data, c 


s.2.3 脉 宽 调制 


1. 脉 宽 调制 状态 图 


移 和 人 的 文件 


model, ec 与 model.h 


model. h 


model, c 


PWM 技术 利用 微 处 理 器 的 数字 输出 量 , 有 效 地 使 数字 电路 具备 了 控制 模拟 电路 的 功能 ， 
广泛 应 用 于 测控 领域 。 本 例 中 ,用 8 位 二 进 制 控制 信号 调节 PWM 信号 的 占 空 比 。 
读者 参考 第 1 章 和 第 3 章 的 内 容 以 及 PWM 的 原理 ,可 以 很 快 得 到 图 5. 2. 39 所 示 的 脉 宽 


调制 状态 图 。 


pwm=f0: 


ef 
val=bin2dec(p7,p6,p5,p4,p3,p2,Pp1,p0) 


图 $.2.39 脉 宽 调制 状态 图 
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其 中 的 Embedded MATLAB 函数 实现 由 二 进 制 转 换 为 十 进 制 的 功能 。 代 码 如 下 : 


function val = bin2dec(p7,p6,p5,p4,p3,p2,pl,p0) 

Vval=p7x*27+p6x 上 26+p5tr25+PpP4xr24+p3x23+p2x# 上 22+Ppl#r21+Ppox20; 

end 

所 用 数据 如 图 5. 2. 40 所 示 ,其 中 i0 一 i7 表示 输入 的 控制 信号 ,v 为 中 间 变 量 , 用 来 表示 脉 
冲 的 占 空 比 ,PWM 为 输出 信号。 


Scope port Resolve Signal DataType Size InitialVvalue CompiledTyp 


Narme 

| Input 工 double 
区 

[ ] input :2 double 
| 这 Input 3 doubie 
[ 吴 

| 1 Input 4 double 
国 

[ 锐 癌 input 5 double 
[ 河 下 Input 6 double 
[杀生 Input ? double 
呈 7 Input 8 double 
[ 辐 pu 

| 上 本 pwm Output 1 double 
[ 河 

f 河 * 有 Vs PR _ 可 


图 5.2.40 状态 图 数据 列表 


2. 功能 验证 模型 
完成 Stateflow 状态 图 之 后 ,在 Simulink 模块 库 中 找到 图 5. 2. 41 .图 5. 2. 42 所 示 模 块 , 并 
按 图 5. 2. 43 所 示 连 接 。 


二 we ”iaiil PSI GUI 
ModerFde Ut 志 3 


i | | 一 HiodelVerification | 
| pa 有 | 上 -NodeLWide Utilities | | | 
IgAn 沿 f 也 委 | 
9 UL Ports 8 Subsystems | 
Signal Routmng | Signalattributes 


“Sinks 


所 So AS 站 scope 
User-Defmed Funciions _ | 


4#- 点 由 己 mmal Maih 大 门 krrpt 


Sources 


图 5. 2. 41 Constant 模块 图 5.2. 42 ”Scope 模块 


| 硬 醒 
CEGFTIOE 





Constant7 Chant 


图 $.2.43 功能 验证 模型 
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完成 以 上 设置 后 执行 仿真 ,输入 端 模拟 外 部 控制 信号 ,在 输入 端 任意 设 定 两 组 不 同 的 电 平 





图 $.2.44 仿真 结果 1 图 S$.2.45 仿真 结果 2 


3. 软件 在 环 测试 


软件 在 环 测 试 (SIL) 是 在 主机 上 对 仿真 中 生成 的 函数 或 手写 代码 进行 非 实 时 性 联合 仿真 
评估 , 当 软 件 组 件 包含 需要 在 目标 平台 上 执行 的 生成 代码 和 手写 代码 的 组 合 时 ,应 该 考虑 进行 
软件 在 环 测试 ,完成 对 模型 生成 代码 的 早期 验证 。 

软件 在 环 测试 不 需要 硬件 ,只 是 对 算法 代码 进行 测试 ,具体 做 法 是 对 要 进行 测试 的 子 系统 
编译 可 生成 SIL 模块 ,比较 原 模 块 与 SIL 模块 的 输出 ,以 此 确认 算法 的 正确 性 。 

在 模块 库 Simulink/Ports 人 Subsystems 中 找到 输入 模块 与 输出 模块 ,替换 功能 验证 模 
型 中 的 Constant 和 Scope 模块 ,如 图 5. 2. 46 所 示 。 










(3 ) 
in3 
(4 
上 
5 





一 一 一 一 一 


Chasrt 


图 5.2.46 代码 生成 模型 


另外 ,还 需要 确保 模型 中 数据 的 类 型 均 为 uint8, 这 里 推荐 用 户 使 用 模型 浏览 器 批量 修改 
Simulink 端口 与 Stateflow 数据 的 数据 类 型 , 既 快 捷 又 可 避免 遗漏 。 

单 击 模型 窗口 的 按钮 昌 ,打开 模型 浏览 器 ,将 流水 灯 状 态 图 里 各 变量 的 数据 类 型 设置 为 
uint8( 图 5. 2. 47) 。 

将 流水 灯 状 态 图 里 ,Embedded MATLAB 函数 模块 内 的 变量 数据 类 型 设置 为 uint8( 图 5. 2. 48) 。 

打开 Embedded MATLAB 师 数 ,将 其 中 所 有 常数 的 类 型 也 转换 为 uint8 : 

function val = bin2dec(p7,p6,p5,p4,p3,p2,p1,p0) 

val = p7 * Uint8(27) + p6 * Uint8(2*6) + p5 * uint8(2-5) + p4* Uint8(2*4) + p3 * Uint8(2>3) + P2 # 
uint8B(2*2) 十 PIx* uint8(2”1) + p0 * uint8(2*0) ; 

end 
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Name scope Port Resolve Signal Datafype Size Initialvalue Compiledyype 
| 固 pwm out.- 1 加 | 
| 辆 m Input 1 

| 辐 忆 Input 2 

[同安 Input 3 

[ 汰 i Input 4 

[ 国 记 Input 5 

[ 国 瑟 Input 厂 

国 上 6 Input 7 

图 17 Input 8 

| 隔 *v Local 站 








天 


Name Scope 

Input 
Input 
Input 
JInput 
Input 
Input 
Input 
Input 
Dutp 


人 
大 到 全 大 十 二 守 吧 少 


会 
达 。 古人 


。 
丽人 


ET FF 2 2 2 22 
[ee 人 

了 吕 瑟 石 站 

型 忆 已 已 又 避 玉 及 已 


s.2.48 设置 Embedded MATLAB 函数 变量 的 数据 类 型 


代码 生成 模型 中 的 In 模块 的 数据 类 型 同样 设置 为 uint8,Onut 模块 的 数据 类 型 可 设 为 自 
动 继承 ,也 可 强制 设置 为 uint8( 图 5. 2. 49) 。 


| Name BlockTfype OutDataTypestr OutMin OutMax Lockscale 
| 舟 Model Worksp. 
闻 Code for state 和 _- 
| ? &dvice for state.. 
| 
| 多 confguwation[- 





莫 m rp fr 0 0 百 - 
过 In2 Or 0 日 和 
已 In3 inpel 日 日 
马 In4 Injpeft 0 日 
己 In5 mpsei 0 日 加 
已 In6 有 昌 可 
己 Im7 D 四 
| 马 ms 加 
| 又 chart 
有 D 四 





| 马 out 


图 5.2.49 设置 模型 端口 数据 类 型 


国 - 基于 模型 的 设计 一 一 MCU 篇 


在 菜单 栏 上 选择 Simulation-~=>Configuration Parameters ,打开 模型 的 参数 设置 对 话 框 , 作 
以 下 设置 :在 Real-Time Workshop 选项 卡 ,设置 TCL 文件 为 ert. tlc, 如 图 5. 2. 50 所 示 。 


Target selection 


System target 侧 e: ert.tjc Browse..、 | 
Language: 『 测 RE 了 aa | 
Description: Real-Time Workshop Embedded Coder 


s.2.50 选择 TLC 文件 
在 Solver 面板 ,设置 求解 器 为 定 步 长 离散 求解 器 ,如 图 5. 2. 51 所 示 。 
Solver options 
Tpe: Redstep 了 | sover [dsarete no contnuoussateg 


Fixed-step Size (fundamental sample time); auto 


图 $.2.51 求解 器 设置 
在 Report 面板 , 勾 选 所 有 复 选 框 , 便 于 后 期 检查 及 跟踪 ,如 图 5. 2. 52 所 示 。 


yi Create code generation report vi Launch report automatically 
Navigation 
vv Code-to-model 


omrmronenrerrmrren 


了 Modelto-code Configure… 


Traceability Report Contents 
Ji Eliminated virtual blocks 
y| Traceable Simujlink blocks 
y| Traceable Stateflow cbjects 


局 Traceable Embedded MATLAB functions 


图 $.2.52 生成 报告 设置 
在 Real-Time Workshop->SIL and PIL Verification 面板 的 Create block 下 拉 列 表 中 , 选 
择 SIL 选项 ,如 图 5. 2. 53 所 示 。 


Software-in-the-loop (SILL) and processor-in-the-loop【PIL) ver 市 cation 
Enable portable word sizes 


SIL or PIL verification block 


Create bjock': S 了 L 


is 


sS.2.53 选择 SIL 选项 
单 击 模型 工具 栏 的 出 按钮 ,生成 SIL 模块 ,如 图 5. 2. 54 所 示 。 
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RTRNW S-Function 


图 $.2.54 软件 在 环 测试 模块 
以 SIL 模块 替换 图 5. 2. 43 中 的 Stateflow 模块 ,重建 验证 模型 ,如 图 5. 2. 55 所 示 。 





RTW S-Function 


图 5.2.5S 软件 在 环 测试 模型 
再 次 输入 功能 验证 模型 中 的 两 组 电 平 , 可 得 到 相同 的 脉冲 输出 。 说 明 SIL 模块 实现 了 





图 5$.2.56 软件 在 环 测试 结果 1 图 5$.2.57 软件 在 环 测 试 结果 2 


4， 自动 生成 代码 


打开 模型 的 参数 设置 对 话 框 ,在 Hardware Implimentation 面板 中 ,设置 器 件 类 型 为 
8051 ,如 图 5. 2. 58 所 示 。 
单 击 模型 工具 栏 的 按钮 妆 ,生成 代码 的 报告 如 图 5. 2. 59 所 示 。 


.255 。 


醒 : 基于 模型 的 设计 一 一 MCU 篇 


Embedded hardware (Simulation and code generation) 


Device vendor: Device type: |8051 Compatible 





图 $.2.58 选择 硬件 类 型 


Back | Forvaard | 1 sinclude <sztdio-hy> ja 25 ert 5 CC eaapIe Ures PnPLEFIUS 方 ， 
1 Sincladse“statet1ow_pymah” 1 首 nde 了 Is 有 eager 在 Je Ni 
Contents 凶 yinclude “rtwtype3.h” 1 3 PPe5 0 
Summary 32 /yz 
Subsvystem Repott + dsSDeIafng rt neStep 0 护 aieo-~fiae cocg Dr Jmterraptf 5e7p?Tce Fouf32ne 
codel f 8 3 六 了 5 HG 广 0f TEie5 the PPerafeg rode “reali-tianc ， 有 he TancfIon re Drestep 17 
2 hr aaFS az5DCE3SHOO 9TTt 为 fw SS Frafe 0 Te RodTIe Siprefes 70 习 amaged 
Traceabiity Report 区 小 轴 r te 让 57P iafe FEroa nsyde fhe zemerafed cpDde， Eniplingassap7zng 
-一 一 一 一 -一 一 一 一 -一 互 Interzupfs 57D 六 ipatinmg Poznf confexf 5e3fcbhes 5Te 5rEzef 5PeCIFTC 了 瑟 35 
王 hzENDIe CO Indiecaores Pere fcse 30DUII fate ace reJatTpe fo ezecutIDn 
Generated Files 
C] 池 省 区 FEmerEfaz Foode Frop Tunefian Doerrin be 为 IO IDDIE ie faiyored fo 
Main file 防 # jpi appPIICafi0n necds Ji5 oaapIo 51MPI Sefs am errDr StatfeS 工 了 站 
et_rnainc 到 Te 是 PdeJ II yetrTS To rt Oneofem. 
te2 声 7 
FModel files 3 woid zt_OneStep(woid) : 
式 ateflow_pwm5 计 void 碎 _Dne5tep (void) 
stateflow_pwmh " 
状 ststlc boolesarT OverrunrFlag = 0; 
小 atsflow_ pwm_ private.h 和 7 
芝 ateflow_Dpwm_ typesh 总 1 区 56Je Inferydpts 用 ie / 
好 
[+] Utility files《i) 8 /和 一 ecr 了 DrF OpPeTon 办 / 
一 一 一 -一 一 一 -一 一 -一 -一 一 一 一 - 4 计 {OvwerrunFlag) { 
f23 rtaSetErrokStstusftstatef1ow_pwm_ “QUvwerrur ) ; 
这 retUrTt 
49 
避 OverrurFlag = TEKUE : 
了 172 SBVWP FF Cone here 个 六 mecer5Er) 7/ 
3 1 Roverniabhio +zmer Dr dnferroptf 态 ere 当 / 
5 AAA Se2tf Edge 加 PUS here 上 
委 7 5ep ee OUe 0 
37 zsateflow Pa ztept) : 
4 RonanaeicaoEiiuadioucasapeia PR 一 aaa 








图 5.2.59 代码 报告 
打开 Keil uVision4 ,选择 芯片 AT 89C51 ,建立 工程 ,并 加 入 生成 的 代码 ,如 图 5. 2. 60 所 示 。 











WU statflow_pwm - pbVision4 一 
Ele Edit Wiew Projed Flash Debug Peripheral  Iool5 3YCS 风 imdow Help 
本 和 一 和 大- 于 有 汪 隐 汪汪 村- 下 入 用 和 网 汪 
”从 -和 
7 团 ertumiaiac 让 OO - 







001 口 ， 全 
日 -全 Source Group 1 on “PILE ETE Ja C 
| 1 听 003 
| - 转 Wan 004 | * Resl-Tirte 罚 OZzKshoP 已 DGe GetEI 世 5 
| 外- 国 erLmain.c 005| - 
急 - 国 stateflow_pwm,c 006 | =* ModeI Yez3IOR 
园 rwtypes.h oa | “Re 一 TI 人 OZKSiGP 了 和 二 直到 攻 闫 区 四 办 
= 有 D08 = 有 ETI~T 了 Te OZNXSHNOP Xe ENSerzaScec 
| 回 stat - 中 009 1 * TELC “ezzsrOD 
回 stateflow_pwm_private.h 010 | ”CrCey 3CCzCe CDpae GemeTEERG 口 3 
固 stateflow_pwm_types.h DT * 
| 012 s 工 斌 ICGeT eecczoDrn exzvzLc = 指 
| 国 Projed 攀 8ooks | 1 Funzti| OoTempl- 4 少 


| 


图 5.2.60 建立 Keil 工程 


ee 
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为 了 使 自动 生成 的 代码 与 实际 硬件 的 端口 .寄存 器 等 能 有 效 对 应 , 需 对 ert_main. c 文件 


// 井 include < stdio. h 一 // 删除 该 头 文件 
# include "stateflow_ pwm. h" 

# include "rtwtypes.h* 

井 include < REGX51. H // 添加 51 头 文件 


/x#x Set model inputs here # / 

stateflow_pwm U. Inl = P1 0; // 将 模型 输入 与 硬件 接口 相关 联 
statef]ow_pwm_ U. In2 = Pl1_1; 

stateflow_pwm U. In3 = P1 2; 

Stateflow_pwm U. In4d = P1 3; 

Stateflow_pwm U. In5 = P1 4; 

Stateflow_pwm U. In6 = P1 5; 

stateflow_pwm_ U. In7 = P1 6; 

Stateflow_pwm_ U. In8 = P1 7; 


/ # Step the model #/ 
StatefLow pwm_step( ) ; 


/ *#* Get model outputs here */ 


P3_0 = stateflow_pwm_Y, Outl ; // 将 模型 输出 与 硬件 接口 相关 联 
int_T main(); // 删除 主 函 数 的 参数 
int_T main() // 删除 主 项 数 的 参数 

// 删除 以 下 代码 


//printf(" Warning: The simulation will run forever.， 


// "Generated RERRT main won 't simulate model step behavior. 。， 
/ /To change this behavior select the 'MRT-file 

1//logging "option.\n) ; 

/fflushCCNULL) ); 

while《〈rtmGetErrorStatus( stateflow_ pwm M) == (NULL) ) 

{  /* Perform other application tasks here #/ 
rt_0OneStep() // 调 用 zt_OneStep 盟 数 


} 
} 
单 击 Keil 工具 栏 的 按钮 太 , 或 按 Alt 十 F7 组 合 键 , 在 Output 选项 卡 , 选 择 Create HEX 
File 选项 ,并 指定 HEX 文件 的 格式 HEX-80 ,如 图 5.2.61 所 示 。 
再 单 击 工具 栏 按钮 没 , 重 编译 工程 ,窗口 下 部 的 信息 显示 已 成 功 生 成 . hex 文件 ,如 图 5. 2.62 
所 示 。 
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Dayice | Targe Dutput | usting | User ] c51 | A51 ] 8L5lLecae | BL51 Mac | Debug | Unes | 
Ssleal Faderiorgpeds | Hame of Eeecdtsble， 拘 FHLcouni 


PCeate Executablc， Wight_count 
了 Debog ricmahion fw Browee informatbon 


| 
| 
FF Ceale HEX Fe HEX Fornax [heEx85 癌 | 
全 Creamie LUbay， ht_coontLIB 厂 Ceate Batch Fie 

1 








Debug ”Peripheras IJoos 5VCS Wind bei- 人 
妈 凡 机 9 .由 2 人 7 癌 加 | ea 了 3 相 兴 ， 可 






ToTeTT 





全 二 3 Source Group 1 
内 STARTUPAS51 
而- 园 emainc 

























由 遇 statefiow_pwm-c 1 dez 二 口 :和 
辐 rtwtypes.h ” Reed -7 的 Wi Si we2R 23 :了 ,和 
se DX 大 SRCDP 本 

器 stateflow_Ppwmh sr 四 _ F Xe 豆 < 了 

~ CE VercSLc5 -各 
辐 stateflow_Ppwmm_privateh rr EEC=+ SoUICC code enezacecd om : 识 Eg 方 







回 stateflow_Ppwm_types.h 


谷 bo 










悦 Proledt ds 有 Feneti | 
compiling stateflow Dpwm.c... 
工 mKImSG。。。 
Prograrm Size: data=33.0 xdqata=0 codqe=1065 
Creatincg hex file from "statftlow PbPwm" ..， 四 


”StatflLow pwmn” 一 0D Errcr(s)，0 Warning(s) . 








Simulation 


图 5.2.62 编译 生成 HEX 文件 





s. 虚拟 硬件 测试 


根据 本 章 第 5. 1 节 的 介绍 ,建立 Proteus 模型 ,并 在 P3_0 口 接 人 虚拟 仪器 Oscilloscope 来 
观察 输出 的 PWM 波形 ,如 图 5. 2. 63 所 示 。 


C1 


和 


P1D 
P 
FM 了 
P13 
阳 志 
孙 往 
辣 
P7 





和 TB9C5S1 


图 $.2.63 脉 宽 调制 Proteus 模型 
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加 载 HEX 文件 并 执行 仿真 后 ,通过 调节 控制 电 平 , 可 以 从 虚拟 示波器 中 看 到 脉冲 占 空 比 
的 变化 。 如 图 5. 2. 64、 图 5. 2. 65 所 示 。 





VSM Oscilioscope 共和 VSM Decilioscope 下 














CHT 国 2 C 呈 22 潭 








图 $.2.64 虚拟 硬件 测试 结果 1 图 5$.2.65 虚拟 硬件 测试 结果 2 


通过 上 述 一 系列 测试 ,证 明了 基于 模型 的 C51 单片机 的 代码 快速 生成 是 可 行 的 。 手 工 代 
码 加 自动 模型 代码 的 方式 ,是 近 几 年 才 开始 流行 的 开发 嵌 人 式 系 统 的 新 技术 ,可 大 大 提高 开发 
效率 ,实现 从 概念 到 实现 的 设计 理念 。 


s.2.4 流水 灯 


1. 流水 灯 状 态 图 
流水 灯 是 单片机 的 常见 应 用 ,其 特点 是 若干 个 灯泡 按 设 定 的 时 间 依 次 点 亮 。 根 据 第 3 章 
的 介绍 ,很 容易 建立 流水 灯 的 状态 图 ,如 图 5. 2. 66 所 示 。 


reset 





ef 
a=0lb=0c=0:d=0'e=00:9=D:h=0: 


图 5.2.66 流水 灯 状 态 图 
其 中 输出 变量 ab...g,.h 表示 8 个 灯泡 的 点 亮 状态 ,事件 TIC( 上 升 沿 ) 表 示 计 数 时 间 到 ， 
如 图 5. 2. 67 所 示 。 
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Name SScope Port Resolve Signal Datafype Size InittiaNalue Compiledfype CompiledSize Ti9gger 








[加 Output 1 国 double 局 1 | 
器 output 2 辣 double 
器:* Output 3 属 double 

轿 d output 4 曾 double 

加 output 5 ” 癌 double 

回 * output 6 ”区 double 

器 8 output 7 ”加 double 

器 n output 8 加 doubile 

多 瑟 input 1 Rising 
Contents 于 Rear 中 Resws | 





图 5.2.67 状态 图 数据 与 事件 列表 


2. 功能 验证 模型 


完成 Stateflow 状态 图 之 后 ,在 Simulink 模块 库 中 找到 图 5. 2. 68 一 图 5. 2. 70 所 示 模 块 ， 
并 按 图 5. 2.71 连接 。 


- SignalAttributes 
ij Signal Routing 
| -sm > 1 > 
ifSources | 
| iuUser-Defined Functions 
| FF 
| 由-Addiional Math & Discrete Golo 
HH 区 Aerospace Blockset 人 | 
图 $.2.68 From 与 Goto 模块 
上 Ports 8 Subsystems 机 | t+ 惑 Fuzzy Logic Toolbox 
一 SignalAttributes -了 吏 Sauges Biockset 
|- Signal Routing | =- -Global Majc ActrweX Library 
hi Sinks | | | 一 Angular Gauges 


j | 
-User-Defned Functions Wu 因 Raa Rac 


Pulse Generstcr 和 | 

| 由-Additional Math & Discrete 一 Linear Gau0es 

+ 出 Aerospace Blockset | INumeric Displays 本 
图 $.2.69 脉冲 发 生 器 模块 图 5.2.70 红色 LED 模块 


Chart 铅 ] 向 向 


图 $.2.71 功能 验证 模型 
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选择 模型 主 窗口 的 菜单 项 Simulation-~>Configuration Parameters… ,打开 模型 参数 对 话 
框 ,在 Solver options 面板 中 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 5. 2. 72 


所 示 。 
Solver options 
ec HORSE 
Type: | Fixed-step | Solver': discrete (no continuous states) | 


Fixed-step Size (fundamental sample time): 0.01 


图 5.2.72 求解 器 设置 
双击 脉冲 发 生 器 模块 ,根据 实际 需要 设置 脉冲 周期 与 脉冲 宽度 (图 5. 2.73) 。 


Parameters 


pie ape 


Time (0: [usesmuatontme 了 





Amplitude: 

1 
Period (secsj: 

5 
Pulse Width (9 of period): 
10 


Phase delay (Secs): 
0 


氏 ] Interpret vector parameters as 1I-D 


图 $.2.73 设置 脉冲 周期 与 脉冲 宽度 
完成 以 上 设置 后 执行 仿真 ,模型 中 的 LED 模块 顺序 点 亮 ,如 图 5. 2.74 所 示 。 






Pulse 
Generator 


图 $.2.74 功能 验证 仿真 结果 
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二 基于 模型 的 设计 一 McU 篇 


3. 软件 在 环 测试 
(1) 数据 类 型 转换 。 在 模块 库 Simulink->Ports &. Subsystems 中 找到 输入 模块 与 输出 模 
块 , 替 换 图 5. 2.71 中 的 脉冲 生成 器 与 Goto 模块 , 删 去 From 与 LED 模块 ,并 将 模型 另存 。 
单 击 模型 窗口 的 按钮 色 ,打开 模型 浏览 器 ,将 流水 灯 状 态 图 里 各 变量 的 数据 类 型 设置 为 
uint8( 图 5.2.75)。 
功能 验证 模型 中 的 In 模块 的 数据 类 型 同样 设置 为 uint8,Onut 模块 的 数据 类 型 可 设 为 自 
动 继承 ,也 可 强制 设置 为 uint8, 如 图 5. 2. 76 所 示 。 


Name Blockfype DutDataTypestr OutMin OutMax Lock4 





自 Model.. 

沿 Code 丰 .， 

? 记 dViCce.-， 

Conf 和 9... 

Name Scope “Port Re5solve 5ignal DataType Tig9ger 过 Inl Uinta 
5 洒 mC Input 1 Rising 号 chart 
[ ] 5 Output 1 Outi inherit: auto 0 0 
[ 团 5 Output 2 忆 outz Inherft: auto 0 
[ 涪 * Output 3 局 out3 Inherit: auto 0 0 
[ ] 吉 Output 4 局 out4 Inherit: auto 0 0 
[到 。 Output 5 妆 Dut5 Jnherit' auto 0 0 
[ 辣 ; Dutput 5 忆 out6 Inherit' auto 0 0 
喇 9 Output 7 蕊 out7 Inhertt' auto 0 [ 
四 ] n Output 5 世 outs inheritt: auto 0 0 
图 5.2.75 设置 模型 状态 图 中 的 数据 类 型 图 $.2.76 设置 模型 端口 的 数据 类 型 


修改 后 的 模型 如 图 5. 2.77 所 示 。 


intg 





Chat 


图 $.2.77 代码 生成 模型 


(2) 模型 参数 设置 。 打 开 模 型 参数 对 话 框 ,在 Real-Time Workshop 面板 中 设置 TLC 文 
件 为 ert. tlc, 如 图 5. 2.78 所 示 。 

Real-Time Workshop~>Interface 面板 ,取消 勾 选 不 必要 的 复 选 框 , 如 图 5. 2.79 所 示 。 

Real-Time Workshop 一 ~Report 面板 , 勾 选 所 有 复 选 框 ,便于 后 期 检查 及 跟踪 ,如 图 5. 2. 80 所 示 。 


262。 
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Target selection 


System target 利 e: ert.tc 
bnguage [5 sssas 


Description: Real-Time Workshop Embedded Coder 


图 5.2.78 选择 TLC 文件 


Software environment 





Target function library: [cesycoo se 一 
Utility function generation: [Auto _ ee 2 We ER 
Support: 人 | floating-point numbers fon-finite Turtbers [1 complex nurmbers 

站 absolute time 扩 ] continuous time 局 nonr-inlined S-functions 


方 ] variable-size signals 
Multiword type definitions: ; System defined 更 本 


二 


图 $.2.79 Interface 面板 


名 Create code generation repo 上 t 加 Launch report automatically 
Navigation 
加 Code-to-model 
园 ModeHto-code 
Traceability Report Contents 
加 Eliminated /virtual blocks 
贺 Traceable Simulink blocks 
加 Traceabie Stateflow objects 
同 Traceable Embedded MATLAB functions 


图 5$.2.80 生成 报告 设置 
(3) 生成 SIL 模块 。 在 Real-Time Workshop~>SIL and PIL Verification 面板 的 Create 
block 选项 ,选择 SIL 选项 ,如 图 5. 2. 81 所 示 。 


Software-in-the-loop (SIL) and processor-inrthe-loop (PIL) verification 
己 | Enable portable word sizes 
SIL or PIL verification block 


ceaie bed 


图 5.2.81 选择 SIL 选 项 
之 后 单 击 模型 工具 栏 的 按钮 岗 ,得 到 代码 生成 报告 与 SILL 模块 ,如 图 5. 2. 82 和 图 5. 2. 83 所 示 。 


人 


国 - 基于 模型 的 设计 一 一 MCU 篇 


Back Forward ] 3 内/ 


[ 司 


Contents 2 下 if ldefirued(5_EURCTION BANME》 | 号 
27 fj#define 53_FUNCTION_NANE 1328ght_cocunt_kell_sf 村: 

Summary 3d ”3enadijf 

Subsystenmt Repo 夺 3 

Code interface R t 36 fdefline 5_FURNCTION_LEVEL 2 

Traceabilty Repert 38 AAA 30 msGTIEnapIe ad WiTDiS5SbTJO WII 证 6 emec 2 区 8 55 计 7 

aaaaaaaaEERIGGeeeeeseeesm 2  #if 1defirnedfRTY_CENERATED S_FUNCTIOBD) 

Generated Files -了 基 define 有 ITW_CENERATED S_FUNCIIOB 
JJ 着 erudi 

[-] Main file 0 

St _ main 37  #include 《stdio.hy 


-i #ineIude “aastki kh> 


F] Model files 和 incliude “zimstruc.h” 
jaht_ sount keilc 和 #include“fixedpoint.hr 
ioht_count_keth 了 T7” #defline rt_logging hh 
J2 jdefine RTVWSfcnInfo VOL 放 
hoht_ count_kell_privateh 了  %include “laght_count_Reil,h” 
ff statlc ant8 TIT light_count_kelil_sf_courtEk = 0; 
[] Utility 刘 es 3 
此 wtypes.h 3 “we 
在 5 FapefIom register5 霄 Jp ad pafpotf 531806 PzopE 
[] Interface files 了 了 w emerateI ERT Codeo. 
jhk_sounk_keH_Ssfx 3 
ee 7 static void ndlInitializeSizes(SimStruct +5) 
dd { 


_Ae 各 om ovemesaer 赤 


图 5.2.82 代码 报告 





RTW S-Function 


图 5$.2.83 SIL 模块 


以 SIL 模块 替换 图 5. 2. 71 的 Stateflow 模块 ,重建 验证 模型 ,如 图 5. 2. 84 所 示 ,并 在 各 端 
口 间 加 入 必要 的 数据 类 型 转换 模块 。 该 模型 的 运行 结果 与 图 5. 2. 74 是 一 致 的 。 





RTW S-Function 


图 5.2.84 软件 在 环 测试 结果 
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4. 自动 代码 生成 及 编译 


(1) 指定 硬件 。 打 开 模 型 参数 对 话 框 ,在 Hardware Implimentation 面板 ,设置 器 件 类 型 
为 Intel 8051 Compatible, 如 图 5. 2. 85 所 示 。 


Embedded hardware (Simulation and code generation) 


Device vendor: Intel | Device type: |8051 Compatible -] 





图 5.2.85 选择 硬件 类 型 
将 Real-Time Workshop->SIL and PIL Verification 面板 的 Create block 选项 ,恢复 成 
none, 如 图 5. 2. 86 所 示 。 


Software-in-the-loop (SIL) and processor-in-the-loop (PIL) verification 
| Enable portable word sizes 
S 蕊 or PIL verification block 


S$.2.86 取消 SiL 选 项 
单 击 模型 工具 栏 的 按钮 当 , 生 成 代码 ,报告 如 图 5. 2. 87 所 示 。 


Back Forward | 


基 nceludas <gtdieo,jh> AU 了 25 Bt 万 563 
#imnclude “light_count_keil.h” ww pdade7 5 太 e5der 于 
Contents #3arclude “rtwtypesh” Au thNors fyPeET 
Sumrnary 3 
Subsystem Report w Jsserz5tinz zt DOnestfep Tt 信 3 eal-fIme czIoc 开 or Inferzl | 
Code Intearface Report 了 5 1 方 5f 三 Eemeratea code “rea7-f3zne ， 了 功 e funzl 峡 
Tr ji yk SI7Ba 555p05tfeI Tt 太 te 六 55 Tafe 0D7 1 为 e 万 0I67 3 i 
yy 力 7 下 ee 六 5P Tate 了 TO IT5TGe 区 ee BeneratfeT code， psphj 了 
2 * mrferopts and FI7oafIing Poznt conferft 5sdytches Sre tarel 已 
Generated Files kr Byanprie roae inadzcafte5 here 臣 ese 动 oUd ta Psce 6 
[-] Main file 起 w Ceneratez Dode 5tfep Tomncfzion ， Direrrin 六 ayipr 5 
ae iain Fr JI SPpiIPatIDP Deeds， 项 75 eampIe 57NPTIy 5ef5 ED 0 
下 # eg 了 -ff37e 万 0deJ 了 5ng TeflrTm5 节 rom Tt LeSreP， 
[-] Model files 有 
void zt_OneStep(void) : 
laht count KellLc - 
z _ Void rt_0Onestep (void) 
Iaht_count_ Keilh | 
liaht_count keil_private 沾 6 static boolean TI OverrunFlag = 0 


ltaht count kel typesh 


[ 广 ] Utility files 2 
2 上 也 jBER ED DIEPEEIEYT 册 / 
上 Ewtypes.h 玫 if (OverrwurElag) 
t+ 也 SetErrorStatus(lieght_count_keIl 也 “DOvetrur ) : 


Fr DT5585Je IDFOFTFUPES 态 ere 出 


s.2.87 代码 报告 


(2) 建立 Keil 工程 。 打 开 Keil uVision4 ,建立 基于 AT89C51 的 工程 ,将 图 5. 2. 87 所 示 


的 6 个 文件 与 Keil 工程 保存 在 同一 目录 下 ,这 样 在 编译 时 ,编译 器 会 自动 找到 所 需要 的 头 文 
件 ,无 须 手 工 添 加 ,如 图 5. 2. 88 所 示 。 


， 国 基于 模型 的 设计 一 一 MCU 篇 


| 玉 作 蕊 同 邓 了 过 过 过 
Teow1 
闫 ETaroctl ai 
闻 已 名 SourceGroup1l 
[ 国 STARTUP_A51 | imnclude <scdic.h> 
日 - 因 etmain< 1 1Pclude "1IGhz_ counc_ keilinn 
_ 四 sadioh 020 和 2nRC1UGe 

柯 hghtceunt_kml-h 

辐 xddefh 

器 snngh 

四] fwtypesh 

加 metsh 

划 隐 ht_count_keil_ typesh 

巴 汐 1ight_cowunmt_ keic 

: 梧 1 人 htcount_keilh 

司 stddefh 

司 singh 

辐 rtwtypesh 

四 mitsh 

本 19ht_cceunt_relltypesh 

可 h9ht_count_kalLpnvateh 


naz2ace3 Rexe “heSe 3hRouUlS 7 
=s5eG code scepPp Danocrtorn。 
5 DPCOSSAAOIO 疙 EGG 。 


RE ICEe sn3 Zetizns 上 zc YE GoesScep 


Lvoid xc_Dne3Scep (void) : 
void zx_Onescep vold) 
1 


Static boolean T COvezxzunEFE1ag 一 : 


022 ; ， 
023 
005 | 
ns 
027 | 
028 } 
029 | 
030 | 
0 ) 
032 |; 
033 
094 
0955 
096 
7 
038 


归 近 会 有 CEYUPER 六 本 Ye 


和 


ee | 





s.2.88 建立 Keil 工程 


单 击 Keil 工具 栏 的 身 按 钮 ,或 按 Alt 十 F7 组 合 键 ,在 Outpnut 选项 卡 , 勾 选 Create HEX 
File 复 选 框 , 并 指定 HEX 文件 的 格式 HEX-80 ,如 图 5. 2. 89 所 示 。 


Device | Taroet Output | Using | User ] c51 寺 A51 | 8L51 Locate | 8L51 Mac | Debug | Uses j 


Seleci Folderfor Ghiects . | Name of Executable- jeount 


-一 一 -一 一 一 一 一 -一 一 ~ 一 一 -一 -一 一 一 一 一 一 一 一 


全 Craate Euecutable，Noht_count 
邮 Debug Infomnation Browse Infomnaton 


节 Ceate HEX Rie HEX Fomnt: [hexeo =] 








”Create lbhrary， ioht court1 昌 


图 5$.2.89 设置 输出 格式 


(3) 代码 修改 。 刚 刚 生 成 的 代码 仅 实现 了 Stateflow 算法 ,并 未 包含 任何 硬件 接口 ,因此 
还 需要 将 算法 的 输入 /输出 与 硬件 端口 相连 接 , 修 改 的 代码 以 斜体 字 表 示 如 下 ， 


# incluade < stadio. hb 二 A/ 檐 厅 该 头 文 件 
# include "1ight_count keil.h” 
# include "rtwtypes.hy" 


2 
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井 IncJude <REGX51 .了 一 
Int nun= 0; 
void tic() interrupt 1 
人 
Puam 十 十 
THE0 = 〈65535 - 50000)/256 4 
《5655535 - 50000) 节 2564 


Volid rt_OneStep(void) ; 
volid rt_OneStep(volid) 
人 
1/ Step the model 
1ight_count_keil_ step(); 
// Get model outputs here 


P2 0 = 1ight_count_Kelil_ Y. Outl ; 


P2 7 = 





[/ 甸 娘 该 头 文 伴 
[A 企 财 奈 去 
[1 什 肝 带 0 由 新竹 序 


[1/ 定 肝 藤 志 
[/[ 馆 肝 0 .055 的 高 位 万 共 
[/A[ 逢 时 0. .0565 的 话 伺 砷 但 


Jight_count Keil Y. Out8 ; 


[[ 奖 葵 册 ZaGpt_coupt_4hezZ_ 上 Ci 等 与 颁 原 硬件 茶 口 洽 共 


Int_Tmazn(); 
Int_Tmain() 
{ 19ght_count_Kkeil initialize(); 
TMOD = 0x01 ; 
(65535 - 50000)/256; 
(65535 一 50000) 和 256; 
DOx82; 
TRO = 了 了 ; 
Tight_count_keii_UD,. Inl = 
whziJe(I) 
{ ifE(Cnum ==1) 
{ num=0; 
Jight_count_keil_U. Inl = 


0 


} 
rt_OneStep(); 
} 
// 删 除 以 下 代码 


//printf(" Warning: The simulation will run forever-. 


// 删 内 不 必要 的 答 人 和 参数 
// 栅 风 不 必要 的 猎人 参数 


[A 佐 肝 玫 0 工作 于 276 位 矿 财 钴 态 
上/ 这 肝 0. .055 的 高 从 万 仙 

上/ 估 时 0. 055 的 朗 亿 友人 得 

[A 克 亲人 窃 计 属 2 内 断 

A 户 动 害 有 计 略 

[/ 狂人 信号 万 势 为 0 


AAA 装 忠 爷 计 胡 坡 肝 
[1 定 肝 厅 志 清寺 
一 1]1i9ht_count_ Keil _ DIDp1; 
[1 番 送 葵 人 售 导 , 颁 现 Siateow 展 闻 入 且 


/Generated ERT main won't simulate model step behavior.“ 
/To change this behavior select the "MRT-file 


/1/logging '" option.Nn ") ; 
/7/fflushCCONULL) ) ; 





代码 修改 完成 后 单 击 工具 栏 按钮 音 , 编 译 工程 ,如 图 5. 2. 90 所 示 ,窗口 下 部 的 信息 显示 已 


成 功 生 成 HEX 文件 。 





3 
人 1 


让 汪 人 





| 后 9PLcount - PVisicon4 了 
上 人 


| me Et 站 sew Proect Hash Debug Peripheral TIoog VC5 mdow Hep 
| -了 -3 E . 习 
区 天 训 Target 1 " 太 包 










[已 洒 Targel FT TSTTSSTEERRED TS TIEOD 
1 司 ; 汪 Source Group | 008 从 在 志 工 一 了 二 入 老生 CE 1 eaBZECG 定 
央 STARTUP.A51 上 003 
习 国 etan<c | DiI0i * 总 请 
问 sdieh 
| 本 由 ht_count_kwish ar 各 
回 stddefh at 
加 stmngh | 二 005， Yaazaara 5 
加 retpPesh 1 06 >* 
同 mtsn | 0I7 
辐 19ht_count_kalLtypesh 上 0I81 sz2nc2ude <3cdieD7 
加 eglh | 019 和 2PCi2de “BE _CORTIE_ je" 蕊 
届 区 由 ht_count_kell<c | 3 SECSORCS+ 汪 ” 





























| 司 waeql 人 seocsl0scstarenj 1 


| bbild argec Targec-1t 汉中 站 下 
从 asserbIin9 STARTOPE .ASI., ， 
具 =cmpilzng ezc_paxznc.。， 





comPIL250 1295S_ coconC5_ Xe2c，。 
司 323SK2nS 
出 ~==” SRRNIWG Z16: SNCXL2ED SECGMENT，TCIORED ZOR DVERLAY PROCESS 
5SEGNMEXNT: ?3FR3LIEGRNIT_CCUNTE 王 开 TERMINRIETLISHT_COSRNT_ 汪 Ix 
Ezc7zamh SIZe Gacas0.0 Xdaca0 2cdem325 
CSS ReX 和 2 300 ”23288522R2 。 ，， 
2z9hc_ cozsnt”~ D Ezzczf1sj， 2 Warningiasl 。 





5.2.90 编译 生成 . hex 文件 


sS. 虚拟 硬件 测试 


根据 本 章 第 5. 1 节 的 介绍 ,建立 proteus 流水 灯 模 型 ,并 加 载 先 前 生成 的 HEX 文件 。 单 
击 “ 仿 真 " 按 钮 ,模型 即 以 0. 1 s 为 间隔 ,逐一 亮 灯 , 实 现 了 Simulink 模型 所 设计 的 功能 ,如 图 
5. 2. 91 所 示 。 


C1 


C2 12 MHv 


罚 同 母 届 同 民 忆 要 


SR 间 
全 二 


) (下 ) 人 于) 





momo 上 让 全 


时 





图 $.2.91 虚拟 硬件 测试 结果 
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人 


VCTAASEAVAA 了 AT DGPeTYUCLCETTYINTEREEOBTIREIOURR AR VDHBDVUYDE - 


TASKING 是 一 家 专业 开发 嵌入 式 系统 软件 工具 的 公司 ,1974 年 创建 于 荷兰 ,2001 年 并 
人 和信 Altium, 其 产品 仍 称 作 TASKING。TASKING 的 交叉 式 编 译 工 具 、. 调 试 器 、 集 成 开发 环境 
(IDE) 实时 操作 系统 (RTOS) ,广泛 支持 各 种 艇 人 式 领 域 的 DSP.8 -16-32 位 处 理 器 与 微 控 
制 器 。 读 者 在 本 节 末 尾 将 看 到 ,对 于 同样 一 段 C 代码 ,使 用 TASKING 编译 器 可 以 得 到 比 
Keil 更 高 的 编译 效率 。 


s.3.1 预备 知识 


1. 软件 下 载 与 安装 
MathworksR2010b 支持 的 TASKING 版 本 如 表 5. 3. 1 所 列 。 
表 $.3.1 MathworksR2010b 支持 的 Tasking 版 本 


处 理 器 编译 器 版 本 
上 Infineon@@ TriCore@@ TASKING VX-toolset for TriCore v2. 5 r2 
Infineon 侠 C166 图 TASKING Tools for C166/ST10 v8.7 rl 
Renesas M]16C TASKING Tools for M16C v3. 1 rl patch 2 
ARM 人 全 TASKING C Compiler for ARM v2.0 r2 
Freescale DSP563xx TASKING Tools for DSP563xx v3. 5 r3 patch 2 
8051 TASKING Tools for 8051 v7. 2 rl 


用 户 若 没有 对 应 版 本 的 软件 ,可 以 径 自 前 往 : 
http:/ /www, tasking. comy/yproducts/trials-and-demos. shtml, 下载 试 用 版 软件 。 例 如 单 
击 链接 8051 Trial Version ,下载 8051 编译 器 ,如 图 5.3. 1 所 示 。 





克 ma Pr 祭 : Hore > Pr ec > I and vernas 
We TASKING - Trial Request 
Produds 

本 ARM VKAoeclseks T0 训 Version 
ReSCUCc8 





ea ks6L2926TIalLVeraon 


na 2 Triaiversion 


图 $.3.1 试用 版 软件 下 载 页 面 
严 - 一 - 659 


咒 : 基于 模型 的 设计 一 一 MCU 般 


在 后 续 打 开 的 注册 页 面 里 输入 必要 信息 , 按 下 右 下 方 的 Continue, 即 可 下 载 (图 5. 3. 2) 。 








aasaa sg :omc 
PR TASKING - 8051 toolset Trial Version Request 
Prpzguct 
-nn Contact Details 
Pirst Mame | Last Name | 
Em3 | 
Departrmerk Job tl 
Phone | 上 
Compa | 
address 
Kty | tej/Provinc 
2 有 
Countryw/Regon | Please Select 
I wowld jike to: 
可 Downioad the 8051 toolset Tnal Version fles ee 


1 Continue ] 


图 5$.3.2 注册 页 面 


TASKNG_8051_demo_v7.2r6 下 本 全 全 39) 编 主攻 如 图 和 ' 不 过 该 试 
21 和 用 版 软件 仅 作为 学 习 之 用 ,如 果 用 于 实际 项 目 开 发 ,为 
5M 如 免 不 必 要 的 限制 ,请 读者 使 用 完全 版 的 软件 。 
Tu asl ay 2 按 提 示 安装 完成 , 即 可 作为 常规 的 编译 环境 使 用 。 
不 过 一 般 来 说 , 目前 可 供 下 载 的 试用 版 本 与 表 5. 3. 1 
所 列 的 不 相符 ,由 于 MATLAB 的 配置 文件 仅 针对 默认 版 本 ,无 兼容 性 可 言 ,为 了 当前 的 
TASKING 软件 能 与 MATLAB 配 合 使 用 ,配置 文件 必须 进行 修改 。 
请 用 户 登 录 北京 航空 航天 大 学 出 版 社 网 站 “下 载 中 心 ", 下 载 经 过 修改 的 EDE 与 pit 
文件 。 


2. TASKING EDE 的 使 用 


(1) 打开 TASKING EDE [18051] ,选择 菜单 项 File 一 Change Directory, 设 置 当 前 工作 目 
录 ,例如 …\test, 如 图 5. 本 4 .图 和 5 所 示 。 


(2) 选择 菜单 项 File 一 New Project Space… ,创建 新 的 工程 空间 ,在 Filename 栏 中 输入 工 
程 空间 名 (如 Hello World) ,如 图 5. 3.6 所 示 。 


创建 后 的 工程 空间 里 , 尚 不 包含 任何 工程 ,如 图 5. 3.7 所 示 。 


(3) 在 工程 属性 对 话 框 中 , 单 击 按钮 妈 , 为 该 工程 空间 新 增 一 个 工程 ,名 为 Hello World， 
如 图 5. 3. 8 所 示 。 


创建 的 新 工程 里 无 任何 代码 文件 ,如 图 5. 3.9 所 示 。 





“270 昌 说 


第 5 章 8051 单片机 代码 的 快速 生成 村 





图 5.3.4 设置 工作 目录 菜单 图 5.3.5 设置 工作 目录 


Current Directory 
G:AMATLABAbooksMCUAMight 


Filename: 
hh ello world 


rw Look in same directory for extermal workspace 
Ce 0 
| 


三 点 uto syrrc WiD 人 SP5Ce 





一 一 一 -一 一 -一 -一 -- 一 一 -一 -一 





图 5.3.6 创建 新 的 工程 空间 


Diectolies | Members | Tooks ] Eros ] Faers | 
Proiect Space，GAMATLABAbook\MCUAtestsHelo World psp 


Proiects 过 局 基本 | 





<Dehault Settngs> 


[ee ed 扣 Prolect | 





厂 Hide proiects aleady in proiect space 
广 External Workspace': 一 一 一 一 一 一 





ee 时 | 划 


一 一 一 -一 一 一 





[em | 


图 5$.3.7 工程 空间 属性 





可 ”基于 模型 的 设计 一 一 MCU 篇 


动 Delauk Setingsy Diectolies | Members | Tooks | Emos | Fhes | 


便 Helo wond ll Prolech Proiect G:\MATLABAbookAMCUNtestNHelo world phk 
[EST 





Curent Directoly 
G:NMATLABAbookAMCUAtest 

六 Hide files aheady in proiect 
Flename- 


HOWoid Extetnal Makehile: 


cnoney 时 公 | 
fw Look in same diectom for extemal makefile 
Makefle， 
Type: 





Browse .| DK Cancel | Help | 


图 $.3.8 添加 新 的 工程 图 5$.3.9 工程 空间 属性 





(4) 单 击 图 标 图 ,为 当前 工程 新 增 一 个 源 代 码 文件 ,例如 hello. c, 如 图 5. 3. 10 所 示 。 


Currenkt Director 
GMAaTLABAbooksMCUNtest 


Plenarmne: 


[helo .< 
Browse.. 


图 5$.3.10 添加 源 代码 文件 
这 时 工程 属性 对 话 框 的 文件 列表 即 显示 该 文件 的 路 径 ,如 图 5. 3. 11 所 示 。 





《Defaull Sellingsy Diectories | Members | Tools | Emos | Faers |j 
Helo World [1 Proiech] 








Prolect GANMATLAB\bookWMCUNtestNHelo World .pk 
or 村 帮 和 PenggRERE 
| Fies | 和 提 | 呈 | 交 | 加 一 
aa 
| | Hidefiles aready in Brolect Dof1 selecled 
Extemmal Makeflle: 
| 1 
| 《none》 时 :| 芭 ] 
| 
- | 








图 5.3.11 工程 空间 属性 
在 随后 打开 的 编辑 窗口 中 添加 以 下 代码 ,如 图 5. 3. 12 所 示 。 


: .272 ， 系 
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剧 TASKNG EDE [8051 - - GAMATLAB\bookNMCUNMestHello Wordpi] ER 
六 1 < ~ RN 
Ele Edi Search project Buitd Tedt oauanert Castomize Window “Help 


和 日 加 儿 阳 刘 广 司 由 由 人 














Tcels 












图 GestNHelo Word psp 
Hejlo Woldfl fi Proecl 

忆 siio Woad 人 Faej | 
忆 苇 ] 5ource Files 
上 二 Prolect Files | 
FL] Resources 
4 Other Fles 
















二， 






站 ee 天 四 Re 六 一 -一 一 一 一 一 一 一 一 一 一 一 一 -- 一 -一 一 一 


心 忆 | jg |@ me 提 j| 让 NBuad AI FieFnd ASeatch ， _Biomwse ， _Diference / _Shel / 上 
Line' 1 







图 5.3.12 编辑 源 代码 


井 define uchar unsigned char 
井 define uint unsigned int 


uchar tl[ ] =" Hello Worldl ?; // 定 义 LCcD 显示 的 字符 
void delay(uint x) // 延 时 国 数 
{ uchar Y; 

While(x--) 

{ for(yY=0Y<100;Y+ + ); 

} 
} 
void write_command(uchar cmd) //LCD 命令 写 人 函数 
{( P20= 0; 

P2 1 = 0; 

P2 2 = 0 

P0 = cnd; 

P2 2 = 1; 

dejlaV(1) ; 

P2 2 = 0) 
} 
void write_data(uchar dat) // 数 据 写 人 函数 
{ P20=1; 

P2 1 = 0; 

P2 2 = 0; 

P0 = dat; 

P2 2 = 1 
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delay(1); 
P2 2 = 0; 
} 


void initialize() /LICD 初始 化 函数 
{ WwWTite_command(0x38) ; 

delay(1); 

WIIite_command(Ox01) ; 

delay(1); 

write_Ccommancd(0Ox06); 

delay(1); 

WIIite_command(0x0fE) ; 

delay( 1) 
} 


Volid main() 
{ uint ii; 
initialize(); 
write_ command(Ox81) ; /1 显示" Hello World1 " 
for(i=0;i<1l2;i+ +) 
{ write data(tl[i]); 
delay(200); 
} 
WhileK1); 
} 


(5) 单 击 EDE 主 窗 口 的 按钮 yY ,打开 工程 选项 窗口 ,在 Processor->Processor Selection 
面板 ,在 下 拉 菜 单 8051 CPU Name 中 选择 AT89C51 选项 ,如 图 5. 3. 13 所 示 。 





| 记 Processor Processor Selecticn 
| CSaecionbyfanW and CPU 
| jemory 售 Selection by CPU 
由- Siartup Code 广 User speciied CPU 
直 CCompiler 
四- Macro Preprocessor 
司 Assembler 
本 bnker 
轩 -CrossWew Pm 8051 CPU Name- [AT89C51 | 
由 - Rasher 
站 
Options shing: 


SFRfile: regat8B51 sfr On chip RANM size: 256 - 





图 $.3.13 选择 处 理 器 
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在 Linker->~Output Format 面板 , 勾 选 Intel Hex records for EPROM programmers(. 
hex) 复 选 框 ,如 图 5. 3. 14 所 示 。 


Output Formzl 

IEEE-695for emulators and TASKING CrossView Pro (abs} 
fw intel Hexrecords for EPROM programmers (he 

六 Motorola S+ecords for EPROM programmers (sre) 
[Edended OMF51for emulstors (651) 

三 Basic ntalOMF51fomf) 

一 二 fl 


厂 Rash aher Buid 





图 $.3.14 选择 输出 文件 类 型 


(6) 单 击 工 具 栏 按钮 沿 编译 工程 ,窗口 下 部 的 信息 显示 已 成 功 生 成 HEX 文件 , 如 
图 5. 3.15 所 示 。 


Blle Ed Search Prajedt Build T 和 Daeunent omaioe 村 
| 和" 号- 人 区 太 园 册 有 多 抑 


G:\_NestNHelo World psp 
Helo wond [1 Proiecb 三 
汪 or wond 2 Piea| wete 一 ， 
中 二 SowceTS Ecoczx1fy=077Y<1007:Y4++) 
辣 Header Fies 
上 口 Prolect Fies 
上- 口 Resouces 
L 问 Diher Fies vezid write command (chazr Crmd) 
FE2.0= 0; 
E2 2 = 0; 


Did delayt(uoznz Xh) 


xszerbling hello worlId Cstart ,SIC 
Linxing 6 hellc world,out 
Crearing IEEE-695 absclute Eile helLlo wozld-aps 


Erzearing Inrel Hex Recozd3 zile _ hello yorld-hex | 


~ 一 iirrereirrreenemermeee weenonol 


寺 站 Buad 人 Fie Fnd 人 Search 人 Browse 人 Diference 人 Shel / 
到 Sr 于 昌 ns Une4 CatT - 





图 $.3.15 编译 生成 HRX 文件 


(7) 根据 第 5. 1 节 的 介绍 ,建立 proteus 模型 ,并 加 载 先 前 生成 的 HEX 文件 , 单 击 “仿真 ” 
按钮 ,LCD 屏幕 显示 Hello World, 实 现 了 C 代码 的 功能 ,如 图 5. 3. 16 所 示 。 


证 - - 
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条 | 本 | 二 | 隐隐 | 王 





图 5.3.16 虚 氢 硬件 测试 结果 


s.3.2 直流 电动 机 控制 


1. 直流 电动 机 原理 
直流 电动 机 的 基本 结构 如 图 5. 3. 17 表示 。 





图 5.3.17 直流 电动 机 基本 结构 
AB 两 电 刷 间 加 上 正 下 负 的 直流 电压 时 ,在 图 5. 3. 17 所 示 的 瞬间 ,电流 的 方向 为 : 电 刷 
A 一 换 向 片 1~a~~b-~c~d-~ 换 向 片 2 一 电 刷 B, 根 据 左 手 定 则 ,导体 ab 受到 向 左 的 电磁 力 , 导 
体 cd 受到 向 右 的 电磁 力 ,电磁 力 对 转轴 形成 道 时 针 方 向 的 转 矩 ,于 是 转子 向 逆 时 针 方 向 旋转 。 


276 四 
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旋转 180 后 (图 5. 3. 18) , 换 向 片 2 与 电 刷 B 接触 , 换 癌 片 1 与 电 刷 A 接触 ,电流 的 方向 
为 : 电 刷 A 一 换 向 片 2 一 dc 一 b 一 a 一 换 向 片 1 电 刷 B, 根 据 左手 定 则 ,导体 cd 受到 向 左 的 电 
磁力 ,导体 ab 受到 向 右 的 电磁 力 , 电 磁力 对 转轴 依旧 形成 送 时 针 方 向 的 转 矩 ,于 是 转子 持续 向 
道 时 针 方向 旋转 。 


生 。 


人 一 一 


_ ii 有 有 B 一 Sa 请 






s.3.18 直流 电动 机 基本 结构 


加 载 在 电 刷 之 间 的 电压 方向 ,决定 了 电动 机 的 旋转 方向 ,为 了 能 方便 地 利用 单片机 控制 电 
动机 旋转 ,可 以 在 两 者 之 间 加 和 一块 驱动 芯片 L298。L298 是 一 款 高 电压 ,大 电流 双全 桥 式 驱 
动 芯 片 , 最 大 工作 电压 46V ,总 直流 电 输 出 4A, 内 部 原理 如 图 5. 3. 19 所 示 。 它 可 接收 标准 的 
TTL 逻辑 信号 ,驱动 感性 负载 ,例如 伺服 电动 机 、 继 电器 、 螺 线 管 .直流 电动 机 以 及 步 进 电 动 
机 ,芯片 提供 了 两 个 使 能 端 EnableA 与 EnableB ,可 分 别 独 立 控制 Outputl1、2 及 Output3 、4 所 
连接 的 设备 。 








图 5.3. 19 L298 内 部 原理 
以 原理 图 左 侧 的 全 桥 为 例 , 若 直流 电动 机 的 两 个 电 刷 分 别 接 在 Outl 与 Out2 引 脚 , 当 In- 
putl、Input2、EnableA 的 输入 为 表 5. 3. 2 左 列 时 ,电动 机 即 按 右 列 的 情况 开始 旋转 或 停止 ( 电 
路 的 实际 连接 ,请 参考 下 文 虚拟 硬件 测试 ) 。 


四 -. 5207 


量 : 基于 模型 的 设计 一 一 MCU 篇 


表 $.3.2 1L298 控制 远 辑 


输 人 功 能 

弄 
ppmpz 快速 信和 

EnableA=0 | Imputdl=xvlnputz=x | 自由 停 转 


2. 直流 电动 机 控制 状态 图 


由 于 本 书 使 用 的 Tasking EDE 是 试用 版 ,有 代码 量 限制 ,因此 根据 上 述 电动 机 控制 原理 以 及 
第 3 章 的 介绍 ,建立 简易 的 直流 电动 机 控制 Stateflow 状态 图 ,如 图 5. 3. 20 所 示 ,实现 电动 机 的 正 
转 、 反 转 与 快速 停 转 的 控制 允 辑 (其 中 EnableA 在 下 文 的 代码 修改 时 ,永久 置 为 高 电 平 ) 。 


motor_stop 
Pen 
forward _ led = 


_2-backward led=D0 





motor forward 





图 5. 3. 20 


motor_backward 
en 

forward jed = 0: 
backward ied= 1-: 





直流 电动 机 控制 状态 图 


其 中 数据 forward_led ,backward _led ,stop_led 作为 电动 机 正 转 、 反 转 、 停 转 的 指示 灯 信 
号 ,数据 Inputl .Input2 作为 电动 机 驱动 芯片 L298 的 正 反 转 输入 信和 号 。 

事件 forward backward .stop 作为 电动 机 运转 的 控制 信号 (下 降 沿 触发 或 根据 实际 需 
要 ) ,事件 tic 作为 激活 stateflow 状态 图 的 信号 。 数 据 及 事件 列表 如 图 5. 3. 21 所 示 。 


| ” Name 

乡 forward Input 

| 光 backward Input 

| 乡 stop Input 

| 乡 ic Input 

|[ 回 forward_ied Output 

| 图 backward_led Output 

| 5tOp_led Output 

民 站 Inputi Output 

加 Input2 Output 
图 5.3. 21 


Scope 





Port Resolve Signal Datafype Tigger Compi 


1 Fallineg 
2 Fajling 
3 Falhing 
了 Either 
1 double 
2 国 double 
了 double 
4 double 
5 double 
状态 图 数据 及 事件 列表 
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3。 功 能 验证 模型 
完成 Stateflow 状态 图 之 后 ,在 Simulink 模块 库 中 找到 图 5. 3. 22 一 图 5. 3. 24 所 示 的 模块 。 


机 Signal Attributes 二 
一 SignalRoutng 


| “| -Signal Routing 一 
| | 
| Sinks | [一 Sinks | 、 


User-Defmed Functons 上 User-Deined Functions 


+HAdditional iath & Discrete 由 -Addional Nath 5 Discrete Step 
+- 岗 Aerospace Blockset 2 二 惑 Aer0space BIOCkset 
4- 蝇 commounicatons Blockset + - 遇 communications Blockset 。 
图 5.3. 22 “Constant 模块 图 5.3.23 Step 模块 

=-- 惑 Gauoces 8lockset 本 
1 后 -Global Majic ActiveX Library 
| Angular Gauges 三 | 
| iDemo Aircraft Instrumenits | 
LEDs 
:Linear Gauges 上 
一 Numeric Displsys Se 
i 一 Percent Indicators 


图 $.3.24 Light Buib 模块 
根据 第 3 章 的 介绍 建立 GUI 界面 ,并 连接 各 模块 ,如 图 5. 3. 25 所 示 。 


forward 





impwt2 


图 5.3.25 功能 验证 模型 
选择 模型 主 窗口 的 菜单 项 Smulation~>Configuration Parameters … ,打开 模 型 参数 对 话 框 ,在 
Solver options 选项 区 域 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 5. 3. 26 所 示 。 


Solver options 
Type: | Fed-step 。 ~| Sokver: | discrete (no continuous states) ~ | 





Fixed-step size (fundamental sample time): 0.01 


图 5S.3.26 求解 器 设置 
受 .279。 


时: 基于 模型 的 设计 一 一 MCU 篇 
双击 阶 跃 信号 模块 ,设置 阶 婚 时 间 为 采样 时 间 的 整数 倍 ,例如 0.2, 如 图 5. 3. 27 所 示 。 


Step 
Output a step. 


Parameters 


jnitial value: 
ee 

Final value: 
1 

Sample time: 
cs 


图 5.3.27 设置 Step 模块 的 阶 跃 时 间 


单 击 模型 仿真 按钮 ,再 分 别 单 击 GUI 界面 的 正 转 、 反 转 、 停 转 按钮 ,LED 灯 即 依次 亮 起 ， 
实现 了 Stateflow 所 描述 的 功能 ,如 图 5. 3. 28 一 图 5. 3. 30 所 示 。 


forward 


加 -一 


Stop 





CE 
Ce 


| backward | 


[Laop | 





forward led 





stop jed 





ss 


Input2 


Chart 


图 5.3.28 仿真 结果 : 正 转 


第 5 章 805s1 单片机 代码 的 快速 生成 攻 





forward 


backward 


stop 


forward led 


Lpackwara 


星 
人 
人 














s.3.29 仿真 结果 : 反 转 


forward 
1 
backward 


stop 


蝇 国 


forward led 
tnrg9er 





backward led 





stop ied 


forward |; 





| backward 





sop 
RE 


Input{! 





Chart 
Input2 


图 S$.3.30 仿真 结果 : 停 转 
4. 软件 在 环 测 试 
(1) 数据 类 型 转换 。 在 模块 库 Simulink->Ports & Subsystems 中 找到 输入 模块 与 输出 模 
块 , 蔡 换 图 5. 3. 25 中 的 常数 、 阶 暑 与 LED 模块 ,并 将 模型 另存 。 


单 击 模型 窗口 的 按钮 图 ,打开 模型 浏览 器 ,将 电动 机 控制 状态 图 里 各 变量 的 数据 类 型 设置 
为 uint8 ,如 图 5. 3. 31 所 示 。 


功能 验证 模型 中 的 In 模块 的 数据 类 型 同样 设置 为 uint8,Onut 模块 的 数据 类 型 可 设 为 自 
动 继承 ,也 可 强制 设置 为 uint8, 如 图 5. 3. 32 所 示 。 


国 -: 基于 模型 的 设计 一 一 MCU 篇 


Name Silockype OutDataypestr OutMin DutMax Lock5cale AccumDa 
基 Mode Workspace 
患 Code for DC_moft... 
争 AdweeforDC_ mm， 
多 Configuration 从 








Name Scope ”Port Resohe Signal Datafype TigWer Compl 已 forward 1 0 
| 更 forward input 1 Falling 加 backward T 0 
| 即 backward input 2 Faling 已 fasttop 1 0 
努 stop Input 3 Falling 已 tngger 1 0 
| 萝 尼 Input EMther 

外 ne 3 加 forward iecd ! inner 浅 auto ] 1 
加 sop led Dutput 3 一 | 辣 backward ied io Inhent' auto 1 0 
| pi ouput 4 1 is 瑟 DP_Iett ipca Inherit' auto 0 0 
| ae | 局 input 5 Inhent auto 0 
图 0 呈 | 志 input2 tp Inhert auto 1 0 

图 5.3.31 设置 模型 状态 图 中 的 数据 类 型 图 5.3.32 设置 模型 端口 的 数据 类 型 


修改 后 的 代码 生成 模型 如 图 5. 3. 33 所 示 。 





Chart 


图 5.3.33 代码 生成 模型 


(2) 模型 参数 设置 。 打 开 模 型 参数 对 话 框 ,在 Real-Time Workshop 面板 设置 TLC 文件 
为 ert. tlc, 如 图 5. 3.34 所 示 。 


Target selection 

System target file: ertstkc L Browse.. ] 
Language: |c 一 

Description: ReaF-Time Workshop Embedded Coder 


图 5.3.34 设置 TLC 文件 


在 ReaL-Time Workshop->Interface 面板 中 ,取消 多 选 不 必要 的 复 选 框 , 如 图 5. 3. 35 所 示 。 
在 Real-Time Workshop 一 Report 面板 中 , 勾 选 所 有 复 选 框 ,便于 后 期 检查 及 跟踪 ,如 
5. 3. 36 所 示 。 


1 .282 稳 





第 5 章 8051 单片机 代码 的 快速 生成 


Softwvare environment 


一 -一 一 一-- 一 一 一 一 一 一 一 一 一 一 -一 一 一 一 一 一 -一 一 一 ~ 一 





Utility funcbon gemeratjon: |Shared locaton 0 ] 有 
| non-fnpke numbers on nurmbers 


”|] non-inined S-functions 


Support: 1Yi foating-pomt numbers 
absolute bme cornuows time 
Variable-sZe Signals 


Multword type definytions: } Systemn defined 


图 $.3.35 lnterface 面板 


[了 Create code generation report 
Navganon 

y Code-io-rnodel 

7 Modehto-code 


Traceabilfty Report Contents 
已 Ehminated /| vrtual blocks 
II Traceable Sirmnulink blocks 


届 Launch report automiatically 


可 Traceable Stateflow objects 
歼 Traceable Embedded MATLABS funcbons 


图 5.3.36 生成 报告 设置 


(3) 生成 SIL 模块 。 在 Real-Time Workshop~>SIL and PIL Verification 面板 中 的 Create 
block 下 拉 列 表 ,选择 SIL 选项 ,如 图 5. 3. 37 所 示 。 


Software-in-the-loop (SIL) and processor-in-the-loop (PE) ver 闪 cation 
| Enabie portable word sizes 
SL or PIL ver 币 cation block 


图 5.3.37 选择 SIL 选项 


之 后 单 击 模型 工具 栏 的 按钮 当 ,得 到 代码 生成 报告 与 SILL 模块 ,如 图 5. 3. 38 和 图 5. 3. 39 所 示 。 


sacc Forwerd 册 
ai idefined(S FURNCTION NANE) 恒 
Cosheshs 33。 #defxne S_FUNCTIOR_NAIE DC_aotor_sil_xf 村 
Summary zarvd:f 4 局 
Suhsyskem Repe 
ea #defsirie SS FUNCTION_ LEYEL 2 
Code jnkerface Repert 
Traceabiity Repo 上 tt rz SO nilEnabhje an NIDIsabJya will go ened in 全 9 TSFfFGC 广 
7 af rdofinecd(RTE CENMERATED 3_FURCTION) 
交 本 dx : S 0 
C ted Files defaxne RIW_GENERATED S_FUNCTION 
大 eridaf 
[-] Main fle 
eat_Imainx 羡 includes 《stdao. hy 
部 inciude “nativ 上 
[-] Model 得 es finmclude “sinstruc.H” 
DC_PmakQr _ 55 include“fixedpeint hh 
#degirne xt_loggineg_ jh 
DC motor 亿 申 #define RTVWSfcnInfo void # 
RE_mAkST 到 pv 站 hh sincliodie“DC_ ntaor_ 1” 
RS_mator 到 txossh |] 


[-] Shared Uiity iles 
攻 w_ shbarsd Ms 


static inta T IC_mnctor_sil_sgt_couneer = 


hh 六 疙 metion retyrters the Inpof ad pofPof 5Pme] Propere3es 0 坊 e 


此 wtyDes Fr enperated EFT Fode 
[-] jnterface 和 es w 
卫 ststxc olid adlIrnat2aiizeS7z63(S2AS4ATVCA *S) 
DG_Pkar 则 直 5 
[Fn Peraaecfter mw/ 


FF Prm 中 4 六 ~ 


图 5.3.38 代码 报告 


辆 - 基于 模型 的 设计 一 一 MCU 篇 





RTW S-Function 


图 5$.3.39 SIL 模块 
以 SIL 模块 替换 图 5. 3. 25 的 Stateflow 模块 ,重建 验证 模型 ,并 在 各 端口 间 加 和 人 必要 的 数 
据 类 型 转换 模块 。 
若 用 户 仍 计划 使 用 GUI 界面 进行 SIL 测试 , 则 必须 确保 各 个 输入 模块 (常数 与 阶 牙 模块 ) 
的 采样 时 间 为 0, 如 图 5. 3. 40 所 示 ,或 与 SIL 模块 的 采样 时 间 一 致 (0.01)。 使 用 任何 其 他 的 
采样 时 间 都 将 导致 SIL 模块 无 法 正确 读 取 输 入 信号 ,进而 无 法 得 到 正确 的 仿真 结果 。 


Constant value: 

必 Interpret vector parameters as 1-D 
Sampling mode: Sample based w 
Sample time: 


0 


5.3.40 模块 采样 时 间 


正确 设置 了 输入 模块 的 采样 时 间 ,再 进行 SIL 测试 ,如 图 5. 3. 41 所 示 ,结果 与 图 5. 3. 28 
一 图 5. 3. 30 所 示 一 致 。 
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图 5.3.41 软件 在 环 测试 结果 


sS. 自动 生成 代码 及 编译 
参考 第 5. 3. 2 小 节 的 “5. 自动 生成 代码 及 编译 ”内 容 。 


本 - - 量 
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6. 虚拟 硬件 测试 


根据 本 章 第 5. 1 节 的 介绍 ,建立 proteus 电动 机 控制 模型 ,如 图 5. 3. 42 所 示 ,并 加 载 先 前 
生成 的 HEX 文件 , 单 击 仿真 按钮 , 停 转 指 示 灯 亮 起 ,说 明 系 统 已 启动 。 





s.3.42 虚拟 硬件 测试 结果 : 停 转 


分 别 按 下 正 转 、 反 转 按钮 ,得 到 仿真 结果 如 图 5. 3.43 .图 5. 3. 44 所 示 ,说 明正 确实 现 了 直 
流 电动 机 的 控制 。 
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5.3.43 虚拟 硬件 测试 结果 : 正 转 


睫 : 基于 模型 的 设计 一 一 MCU 篇 


丰 5 
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图 $.3.44 虚拟 硬件 测试 结果 : 反 转 


sS.3.3 算术 乘法 


1. 功能 验证 模型 


在 Simulink 模块 库 中 找到 图 5. 3. 45 一 图 5. 3. 47 所 示 模 块 , 并 按 图 5. 3. 48 连接 , 即 可 得 
到 算术 乘法 模型 。 


-- 二 Sirmuklnk | 
| | -commoniy Used Blocks 浊 || 
Sional Routing5 


盖 Continuous | 

Sinks | -Discontinuities | 色 

1 |、 | > 
Enaas ae 


上 广 User-Defined Functions Logic and BtDperations 








二 Additional Math & Dascrete Libegus 了 able Produdt 
Constant | | 
1 晤 ceneooceaoone 四 
+- 鸯 communicatons Blockset | -weodelVerifcation -|| 
图 5.3. 45 “Constant 模块 图 5.3.46 Product 模块 
-- 岗 Gauoges Blodecset 
际 CR Majc ActiveXx Library 
一 Angular Gauges 
下 na Arcraft Instruments 
|--LEDs 
Unear Gauges Generic Numeric LED - 
CT 
IOn Off Gauges Product Generic Numeric LED 
图 5.3.47 数字 LED 模块 图 5.3.48 算术 乘法 模型 


2 位 十 进 制 整数 乘法 的 乘积 最 大 为 4 位 十 进 制 整数 ,因此 设置 数码 管 的 显示 位 数 为 4 位 
整数 .0 位 小 数 , 如 图 5. 3.49 所 示 。 


286 。 
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s.3.49 设置 LED 显示 位 数 


选择 模型 主 窗口 的 菜单 项 Simulation~>Configuration Parameters… ,打开 模型 参数 对 话 
框 ,在 Solver 面板 中 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 5. 3. 50 所 示 。 


Solver options 
Type; Fixed-step | Solver': |discrete (no continuous states) 了 | 


Fixed-step size (fundamental sample time): 0.01 


图 5.3.50 求解 器 设置 
仿真 结果 如 图 5. 3. 51 .图 5. 3. 52 所 示 。 





Product Generic Numeric LED 


图 5.3.51 功能 验证 模型 仿真 结果 1 


( 
村 让 了 刁 司 


Product Generic Numeric LED 





图 5.3.52 功能 验证 模型 仿真 结果 2 


2， 软件 在 环 测试 
(1) 数据 类 型 转换 。 在 模块 库 Simulink->~Ports & Subsystems 中 找到 输入 模块 与 输出 模 
块 , 替 换 上 述 图 5. 3. 51 中 的 常数 与 LED 模块 ,并 将 模型 另存 。 
单 击 模型 窗口 的 按钮 昌 ,打开 模型 浏览 器 ,将 Simnulink 模型 中 的 In 模块 的 数据 类 型 设置 ， 


贤 - “287 。 ; 


晤 济 ” 基 于 模型 的 设计 一 MCU 需 


为 uint8 ,Product 模块 的 数据 类 型 设置 为 uint16,Onut 模块 的 数据 类 型 可 设 为 自动 继承 ,也 可 
强制 设置 为 uint16 ,如 图 5. 3. 53 所 示 。 


Name Blockfpe OutDataTpestr DutMin OutMax LockScale 


鄞 Model Worksp.… 
中 Codefor 53il 
? 上 GOViCe fOF Si 


疏 


COnfiguration ,， 


这 Inl Uintg 1 0 
芝 in2 uint5 0 0 
这 Produd uUint16 0 [ 

[ 





芝 Dutl Inherit' auto 


图 5.3.S3 设置 模型 端口 的 数据 类 型 
修改 后 的 模型 如 图 5. 3. 54 所 示 。 





Product 


图 $.3.54 代码 生成 模型 


(2) 模型 参数 设置 。 打 开 模 型 参数 对 话 框 , 在 Real-Time Workshop 面板 设置 TLC 文件 
为 ert. tlc, 如 图 5. 3. 55 所 示 。 


Target Sejection 


System target 介 e: ert.tic Browse..- 
Language: C | 
Description: Real-Time Workshop Embedded Coder 


图 $.3.55 选择 TLC 文件 
在 Real-Time Workshop 一 >Interface 面板 中 ,取消 勾 选 不 必要 的 复 选 框 , 如 图 5. 3. 56 所 示 。 


Software environment 
Target function library: [yesekAnsD: = 


Utilty function generation: | Auto 





Support: floating-point numbers complex numbers 


absolute Ume continuous tme non-injined S-functions 
variable-Size Signals 


Muitiword type definitions: | System defined ee 
图 $.3. 56 ”Interface 面板 


者 "288 直 
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进入 Real-Time Workshop 一 Report 面板 , 勾 选 所 有 复 选 框 ,便于 后 期 检查 及 跟踪 , 如 
图 5. 3. 57 所 示 。 


y Create code generation report y Launch report automatically 


Navigation 
y Code-to-model 


v Modehto-code Configure..j] 


Traceability Report Contents 
v Eliminated / virtual blocks 
vV Traceabla Simulink blocks 
” Traceable Stateflow objects 


vv Traceable Embedded MATLAB functuons 


图 5.3.57 生成 报告 设置 
(3) 生成 SIL 模块 。 在 Real-Time Workshop 一 SIL and PIL Verification 面板 的 Create 
block 下 拉 列 表 ,选择 SIL 选项 ,如 图 5. 3. 58 所 示 。 


software-in-the-ioop 5SL) and processor-in-the-loop{PL) verification 
Enable portable word sizes 
SIL or PIL verification block 


Create block: SIL 8 nd 出 ge 四 "| 


s.3.58 选择 SIL 选项 
之 后 单 击 模型 工具 栏 的 按钮 内 ,得 到 代码 生成 报告 与 SILL 模块 ,如 图 5. 3. 59 和 图 5. 3. 60 所 示 。 


aa | FL idezirmedo_rNCTION ,aaNE) 





#deflxe 3 FUNCTION_RANE sirl_st 
2 endi 
Contents 当 瑟 呆 
Summar 洒 。 g#defirne 3_FUNCTION_LEVEL 2 三 
2 | 刁 
Subsyste O 页 1 50 EPETasie ng COTT6B Te ET De tneg in 护 e 0 肌 5 让 
Code Interface ReporC 22 #ift ldefired(KRTW_ GENERATED_S_FUNCTION) 
Traceabiv 六 | 惕 Ndefine RTY_ CENERATED S_FUNRCTION 
基 eTudl 节 
Generated Files 了 ##include <stdio,jh> 
[-] Main 利 e 7  ##Iinclede 《sth kh 
ea #iclade “simsttuc.h” 
ED 区 LRC1LUde “fixedpoint.h” 
[-] Model jjles #defline rt_1oggIing_h 
siEg tdefine RKTIWSfcnJInto VDE 林 
基 iWClUdGe “ERh” 
旨 .h 
sil_private.h </ statac int8 TIT SI1_sf_counter = 0; 
[-] Shared Utility files 帮 11 FnmcfIom rerISfEFS ft 广 2E TInpiif Sn DEEPDU EPE POPDI 
h * emerasfec ER Doge， 
此 wtypes.h 57 static woid mdlInitializeSizes(SimStruct *S) 
5 
广 ] Interface 利 es z9 /TimasbJe Parameter5 w7 
5 _ 引 5 ssSet 了 msSFcnParanas(S，D) : 


ssSFxpSectUJ325itRegiorConpliant (3S，1) : 


图 5$.3.59 代码 报告 


基于 模型 的 设计 一 一 MCU 篇 





RTW S-Function 
图 5$.3.60 SIL 模块 


以 SIL 模块 替换 图 5. 3. 51 的 Product 模块 ,重建 验证 模型 ,并 在 各 端口 间 加 入 必要 的 数 
据 类 型 转换 模块 。SIL 测试 的 结果 图 5. 3. 61 .图 5. 3. 62 与 图 5. 3. 51 .图 5. 3. 52 所 示 结 果 是 
一 致 的 。 





RTW S-Function Generic NumericLED 


图 5.3.61 软件 在 环 测试 结果 1 





RTW S-Function 


Generc Numeric LED 
图 5.3.62 软件 在 环 测试 结果 2 
3. 定义 输入 /输出 信和 号 


完成 了 软件 在 环 测试 ,用 户 就 可 以 参照 5. 2.2 节 .5. 2. 3 节 或 5.3.2 节 的 说 明 , 自 动 生 成 
代码 并 在 代码 中 添加 必要 的 硬件 接口 代码 ,完成 整个 设计 ,不 过 本 节 采 用 另 一 种 方式 来 完成 ; 
事先 将 硬件 接口 代码 封装 成 一 个 函数 ,之 后 在 生成 的 代码 里 直接 调用 。 

选择 Inl 端口 连接 线 的 右键 菜单 项 Signal Properties … ,如 图 5. 3. 63 所 示 ,信号 命名 为 
multiplicand, 存 储 类 型 为 InportedExtern, 如 图 5.3. 64 所 示 。 


Jint8 
In1 0 | 
oa Sopy Signal name: multiplicand 本 一 一 一 一 一 
于 Dalete | Signal name must resolve to Simulink signal objac 


Highlight To Source Logging and accessibi | Real- -Time Varkshop ， Documentation 
re opt ,pr we ty | Ce ws 
Package; -一 Mone -- 2 ae Refresh | 


Storage class: | ImportedExtern 2 本 3 


Linearization Fats | storage type qualifier: 


人 








s.3.63 信号 属性 菜单 项 5s.3.64 Inl 端口 信号 设置 


”za290。 - 一 - 弓 
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同样 命名 In2 端口 的 信和 号 为 multiplicator ,存储 类 型 为 InportedExtern, 如 图 5. 3. 65 所 
示 。 使 用 RTW 生成 代码 时 ,变量 multiplicand 与 multiplicator 将 被 声明 为 外 部 变量 ， 因此 用 
户 需要 在 编写 硬件 接口 代码 时 定义 它们 。 
Onutl 端口 的 信号 命名 为 product, 存 储 类 型 为 下 xportedGlobal, 如 图 5. 3. 66 所 示 。 该 变 
量 将 被 定义 在 RTW 生成 的 代码 中 ,因此 用 户 需 要 在 编写 硬件 接口 代码 时 将 其 声明 为 外 部 
变量 。 
signal name: multiplicator 格 一 一 一 一 Signal name: produc 二 一 一 一 


Signal name must resolve to Simulink signal objedt Signal name must resolve to Simulink SIgnal object 
Logging and accessibllity ;ReaLHTime Workshop ;， Documentation Logging and accessibility 上 Real-Time Workshop |，Documentation 
Package: me 和 Refresh Package: -一 None 一 - ~| | Refresh 

Storage class: ImportedExtern 姓 Storage class: ExportedGlobal 本 一 一 


Storage type qualifler: Storage type qualifier: 


图 $.3.65 In2 端口 信号 设置 图 $.3.66 Onutl 端口 信号 设置 


打开 模型 菜单 项 Format->Port/Signal Displays, 选 择 Port Data Types 与 Sgnal Class 命令 ,如 图 
5. 3. 67 所 示 ,各 条 信和 号 线 即 可 显示 数据 类 型 ,数据 存储 类 型 以 及 信和 号 名 ,如 图 5. 3. 68 所 示 。 











中 外- 人 -入 Per 了 习 轴 山上 日 几 演 昌国 轿 多 


人 -~ 


9 


PortySgnal Displays Linearization IJndicators 
Biock Displays 人 Port Data Types 
Wibrary Link Display 3gnal Dimensions R 
SampleTime Display hy Y Storageclass 

Tes ~mnnmndicators 


图 5.3.67 开启 端口 数据 类 型 与 存储 类 型 显示 





Product 
图 5.3.68 各 条 信号 线 上 的 信号 属性 


4. 硬件 接口 代码 


根据 上 文 定义 的 三 个 变量 multiplicand multiplicator product 的 存储 类 型 ,在 io.h 文件 
中 声明 这 三 个 变量 。 


.291 】 


上 四 基于 模型 的 设计 一 -MCU 篇 


=*~<- 一 - 


井 include“rtwtypes. h” // RIW 数据 类 型 头 文件 

uint8_T multiplicandi /multiplicand 声明 为 本 地 变量 
uint8_T multiplicator; // multiplicator 上 声明 为 本 地 变量 
extern uint16 _T producti // product 声明 为 外 部 变量 

void input(void) ; // 接口 函数 声明 

void output( void ); // 接口 函数 声明 


在 io.c 文件 中 ,编写 输入 /输出 的 硬件 接口 代码 。 


# include "io.h" 
void input() 
1 int maoltiblicandiy // 中 间 变 量 
int multiplicand2 ; 
int multiplicatorly 


int multiplicator2s 


multiplicand1l = P1 & 0x0F; // 取 输 入 的 低 4 位 

multiplicand2 = (P1 & 0xF0)>> 4; // 取 输 入 的 高 4 位 

multiplicand = multiplicand2 *x* 10 + multiplicandl ; // 组 合成 被 乘 数 
multiplicatorl = P0 & 0x0F; // 取 输 和 人 的 低 4 位 

multiplicator2 = 〈《P0O & 0xF0)>> 4; /7 取 输 入 的 高 4 位 

multiplicator = multiplicator2 * 10 + multiplicatorl; // 组 合成 乘 数 


}) void output() 
{ int productl; // 中 间 变 量 
int product2 ; 


int product3; 

int product4， 

product4 = product/1000; // 取 乘 积 的 千 位 
product3 = product/100 贡 10; 1/ 取 乘 积 的 百 位 
product2 = product/10 贡 10; // 取 乘积 的 十 位 
product1l = product 10; // 取 乘 积 的 个 位 
P2 = product2 << 4|productl; /7/ 千 位 、 百 位 输出 
P3 = pbroduct4 << 4|product3; /7 十 位 .个 位 输出 


) 


sS. 自动 生成 代码 及 编译 
参考 第 5. 3. 2 小 节 的 “5. 自动 生成 代码 及 编译 ”内容 。 
6. 虚拟 硬件 测试 
根据 本 章 第 5. 1 节 的 介绍 ,建立 proteus 算数 乘法 模型 ,并 加 载 先前 生成 的 HEX 文件 , 单 
击 仿真 按钮 ,任意 设置 被 乘 数 与 乘 数 ,得 到 仿真 结果 如 图 5. 3. 69 .图 5. 3. 70 所 示 , 说 明正 确实 
现 了 2 位 十 进 制 算术 乘法 。 
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图 5.3.70 虚拟 硬件 测试 结果 2 


sS.3.4 流水 灯 


本 节 重 用 5. 2. 3 节 所 建立 的 流水 灯 模 型 ,使 用 TASKING EDE 生成 HEX 文件 。 读 者 看 
到 这 里 应 已 了 解 ,整个 设计 过 程 与 前 文 的 差别 仅 在 于 修改 硬件 接口 代码 ,因此 这 里 列 出 需要 调 
整 的 代码 段 ,其 他 步骤 皆 可 参照 5. 2. 3 节 与 5.3. 2 节 。 


# include <stdio .二 AAA 般 隐 该 头 文 伴 
# include "light_tasking.h” 
井 include "rtwtypes.h" 


"293 ， : 


醒 : 基于 模型 的 设计 一 一 MCU 篇 


Int nunm= 0; [1/ 笼 肝 胡 去 
_interrupt(1) void tic( void ) AM 911G EM 的 由 新 给 访 论 义 方 式 
{ num+ +; [1V 爷 计 页 起 


TH0O = (65535 - 50000)/256 A[V/ 估 计 0 .055 的 高 伦 友 和 华 
TLO = 〈65535 - 50000) 有 256 1; AM/ 定时 0 05s 的 低位 友和 借 


Volid rt_OneStep(void); 
void rt_OneStep(volid) 
{ 
// Step the model 
light_ tasking_step(); 


1/ Get model outputs here 
P2 0 = light_tasking_ Y. Outl 


P2 7 = jight_tasking_ Y. Out8 ; 
A[A 奖 葵 员 7Z2GpL_ destzpg 上 Cot 等 与 颁 际 硬 伴 逻 口 让 规 


int_ main(); // 删 由 不 必要 的 短信 矢 数 
int_ Tamain(y) //[ 山 内 不 必要 的 答 人 参数 
{ 
TMOD = 0x01; [V 全 肝 玫 20 工作 于 2Z6 伦 计 夺 庆 态 
TH0O = (65535 - 50000)/25614 /全 肝 0. 055 的 高 伺 坤 候 
TL0O = 〈(65535 - 50000)% 256 [1/ 定时 0. .055 的 低位 初 介 
IE = 0x82 [1A 大 了 攻 害 肝 艾 0 中 断 
TRO = TI# /1 卢 动 这 计 属 
Jight_tasking _U. Inl = 0; AV 葵 人 竺 呈 胡 努 为 0 
whiIe (rtmnGetErrorStatus(Iight_tasking NMH) == (NOLD)) 
{ if(num ==]1) AV 并 中 全 时 厅 起 时 
{ num=0i AV 佐 计 胡 坡 羡 等 
li9ht_tasking U. Inl = 一 Jight_tasking_U. Inl; 
} [1 翻 产 答 人 和 售 叶 , 实 更 StateCow 避 闻 入 好 


rt_OneStep(); 


》 

编译 结果 如 图 5. 3. 71 所 示 。 

在 Proteus 模型 中 加 载 该 HEX 文件 ,可 以 得 到 图 5. 2. 69 所 示 的 仿真 结果 (图 5. 3.72) 。 

用 户 可 以 比较 使 用 Keil 与 TASKING EDE 两 款 编译 环境 生成 的 HEX 文件 ,如 图 5. 3. 73 所 
示 ,由 Keil 编译 得 到 的 HEX 文件 有 2807 字 节 ,而 TASKING EDE 编译 得 到 的 HEX 文件 有 1874 
字 节 ,显然 后 者 的 编译 效率 高 于 前 者 ,这 也 就 是 本 书 介绍 TASKING EDE 编译 环境 的 原因 。 
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图 $.3.72 虚拟 硬件 测试 结果 
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图 $.3.73 比较 生成 的 HEX 文件 员 


第 0 章 
C166 代码 的 快速 生成 





本 章 的 主要 目的 是 介绍 C166 单片机 代码 的 自动 生成 和 处 理 器 在 环 测试 (PIL)。 处 理 器 
在 环 测 试 是 将 模型 自动 生成 的 圣人 式 C 代码 下 载 到 实际 的 处 理 器 中 ,并 和 被 控 对 象 模 型 在 模 
型 中 进行 非 实时 性 联合 仿真 ,通过 真实 的 MO 口 .串口 等 来 交换 工作 在 处 理 器 上 的 嵌 人 式 C 
代码 和 运行 在 模型 中 被 控 对 象 模型 间 的 数据 ,来 评估 算法 的 优 和 劣 。 一 般 进 行 这 样 的 测试 是 需 
要 实际 硬件 的 ,不 过 MathWorks 公司 提供 了 在 TASKING EDE 中 进行 PIL 测试 的 功能 。 但 
只 支持 8051、. 飞 思 卡 尔 DSP563xx 和 英 飞 凌 等 单片机 的 处 理 器 在 环 测 试 , 不 支持 ARM 处 理 器 
这 种 测试 。 第 5 章 的 PIL 测试 被 换 成 了 SIL 测试 ,是 因为 作者 的 TASKING EDE for 8051 软 
件 是 Demo 版 (功能 受 限 ) ,无 法 完成 这 种 测试 。 通 过 本 章 的 介绍 ,读者 同样 可 以 了 解 8051 PIL 
测试 的 流程 。 

英 飞 凌 公 司 作为 全 球 半导体 创新 的 领导 者 , 共 拥 有 41 000 项 专利 , 英 飞 凌 产 品 在 全 球 得 
到 了 广泛 的 应 用 。 特 别 是 在 汽车 尾气 排放 的 控制 方面 有 自己 独到 的 解决 方案 。MathWorks 
公司 对 英 飞 凌 单 片 机 也 比较 感 兴趣 ,如 C166 等 处 理 器 ,很 多 外 设 都 被 写成 了 模块 , 放 到 了 
Simulink 的 模型 浏览 器 中 ,如 图 6.0. 1 所 示 。 
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图 6.0.1 Infineon C166 模块 库 





为 了 满足 习惯 使 用 英 飞 凌 产 品 这 部 分 用 户 , 这 部 分 能 利用 基于 模型 设计 的 思想 从 事 C166 
单片机 的 快速 应 用 研发 ,作者 将 其 单独 作为 一 章 来 给 读者 作 一 简单 介绍 。 由 于 作者 没有 C166 
的 开发 板 ,Proteus 虚拟 硬件 实验 平台 又 不 支持 英 飞 凌 单 片 机 ,无 法 对 自动 生成 的 代码 进行 硬 
件 测 试 。 本 章 仅 以 第 5 章 的 电动 机 控制 模型 为 例 , 来 介绍 C166 代码 的 快速 生成 过 程 , 以 及 进 
行 功能 验证 与 代码 验证 。 不 过 ,读者 只 要 认真 阅读 了 本 章 和 其 前 后 几 章 的 内 容 , 这 种 新 技术 是 
完全 可 用 于 英 飞 凌 处 理 器 开发 的 。 


6.1 英 飞 诬 C166 模块 库 简介 


Target Support Package 是 Mathworks 公司 提供 的 一 款 用 于 开发 微 处 理 器 、 微 控制 器 、 
DSP 等 嵌 人 式 系 统 的 组 件 。 它 可 以 将 芯片 外 设 、 实 时 操作 系统 以 及 由 Simulink 模型 .State- 
flow 图 表 、.Embedded MATLAB 所 生成 的 代码 整合 起 来 ,避免 了 编写 大 量 的 底层 驱动 程序 ， 
可 用 于 岩 人 式 系统 的 快速 原型 设计 及 实时 性 能 分 析 等 。 

C166 模块 库 是 Traget Support Package 的 一 个 子 集 ,与 C166 芯片 的 外 围 驱 动 设 备 一 一 
对 应 ,用户 可 以 在 算法 模型 中 添加 这 些 模块 ,用 于 生成 可 直接 在 嵌 人 式 处 理 器 上 使 用 的 代码 。 

在 Simulink 库 浏 览 锅 中 ,打开 Target Support Package~Support Prossessors 一 IJnfinion 
C166, 即 可 打开 C166 模块 库 。 其 中 包含 有 异步 /同步 串 行 接口 、 数 字 信号 输入 /输出 .中 断 等 
子 模块 库 , 如 图 6.1.1 所 示 。 下 面 介 绍 C166 中 的 部 分 子 库 。 
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6.1.1 InfinionC166 模块 库 
(1) 异步 /同步 串 行 接 口 。 该 子 库 包含 Serial Transmit 和 Serial Receive 两 个 模块 ,如 图 6. 1. 2 所 
示 。Serial Receive 模块 用 于 配置 C166 微 控制 器 的 串 行 接收 功能 ,Serial Tansmit 模块 用 于 配置 器 
串 行 发 送 功能 。 串 行 接收 /发 送 模块 通过 Infineon C166 微 控 制 顺 的 异步 /同步 串 行 接口 ASC0O 
通信 。 既 可 进行 定 字 长 通信 ,也 可 进行 可 变 字 长 通信 。 


“297 ， ; 


如 : 基于 模型 的 设计 一 一 MCU 篇 


(2) 数字 信和 号 输入 /输出 。 该 子 库 包 含 Digital In 和 Digital Onut 两 个 模块 ,如 图 6. 1. 3 所 
示 。Digital In 和 Digital Out 模块 用 于 从 指定 的 端口 或 引 脚 输入 /输出 逻辑 电 平 值 。 


Digital In Digital Out 
办 二 Data Data ASC0 On P2.0 on P20 
办 二 


Transmit 
Digital Out 
Serial Receive Sesrisl Transmm 计 
图 6.1.2 异步 /同步 串 行 接口 模块 图 6.1.3 数字 信号 输入 /输出 子 库 


(3) 中 断 。 该 子 库 包 含 模块 Fast 下 xternal Interrupt, 如 


6.1.4 所 示 。 该 模块 在 中 断 发 生 时 触发 一 个 异步 郴 数 
Faga External 调用 
Interrupt on P2 8 
函数 调用 子 系统 作为 一 个 异步 任务 执行 。 此 模块 可 为 任 


务 分 配 Simulink 优先 级 和 CPU 中 断 等 级 。 
(4) 执行 分 析 。 该 子 库 包含 模块 C166 Execution Profi- 
ling via ASC07VC-CAN LV/CAN AI/TwinCAN A, 如 图 6. 1.5 
图 6.1.4 中 断 子 库 所 示 。 


Execution Profiling Execution Prcfiling Execution Profiling Executiocon Profiling 
via Serial via 世上 请 N via 全 AN Vis 已 六 N 


C166 Execution Profiling C166 Execution Frofiling C166 Execution Profiling C166 Execution Procfiling 
viaASC0 via C-CAN 1 Via 蕊 入 凡 太 Via TwinC 太 N 太 


Fast External Interrupt 


图 6.1.5 执行 分 析 子 库 

C166 下 xecution Profiling via ASCO0 为 执行 分 析 引 擎 提供 串 行 接口 , 当 接 收 到 开始 指 
令 时 ,开始 记录 执行 分 析 数 据 ;: 当 完成 记录 后 记录 下 的 数据 自动 通过 串 行 接口 ASC0 
返回 。 

C166 Execution Profiling via CAN A 为 执行 分 析 引 人 擎 提供 了 CAN 接口 , 当 接 收 到 开始 
指令 时 ,开始 记录 执行 分 析 数 据 ; 当 完成 记录 后 记录 下 的 数据 自动 通过 CAN 接口 返回 。 用 户 
需要 为 开始 指令 和 返回 数据 指定 标志 信息 。 

Cl166 Execution Profiling via C-CAN 1 提供 了 C-CAN 接口 ,其 他 功能 与 C166 下 xecution 
Profiling via CAN A 相同 。 

(5) 工具 。 该 子 库 包 含 模块 Switch 正 xternal Mode Configuration 和 Switch Target Con- 
figuration ,如 图 6.1.6 所 示 。 

Switch External Mode Configuration 将 模型 设置 为 外 部 模式 或 执行 编译 ,在 模型 中 添加 
该 模块 后 ,双击 可 打开 其 对 话 框 , 如 图 6. 1.7 所 示 。 
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6.1.6 工具 子 库 6.1.7 Switch External Mode Configuration 设置 界面 


Switch Target Configuration 模块 可 将 模型 设置 为 一 系列 预 设 硬件 配置 中 的 某 一 种 ,例如 
cl166_sim、cl166cr_ hw、.cl67cs_sim cl67cr_ hw 等 。 


60.2 IAsKINGC EDE for C166 


6.2.1 电动 机 控制 模型 


本 例 将 重用 5. 3. 2 节 的 例子 , 建 模 过 程 不 再 重复 。 开 发 C166 目标 需要 TASKING 专 为 
Cl166 设计 的 EDE 软件 Classic C166/ST10 Trial Version, 下载 安 装 过 程 可 参考 5. 3. 1 节 
内 容 。 

在 模块 库 Simulink\Ports &Subsystems 中 找到 输入 模块 与 输出 模块 ,替换 功能 验证 模型 
中 的 常数 与 指示 灯 , 并 将 这 些 端口 的 数据 类 型 修改 为 uint8 ,如 图 6. 2. 1 所 示 。 
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图 6.2.1 代码 生成 模型 


要 确保 其 数据 类 型 和 stateflow 中 的 数据 类 和 输入 /输出 端口 的 数据 类 型 一 致 ,这 里 仍然 
推荐 使 用 模型 浏览 器 批量 修改 ,如 图 6. 2.2. 图 6. 2. 3 所 示 。 


发 -- - - .299 。 : 
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图 6.2.2 修改 代码 生成 模型 端口 数据 类 型 图 6.2.3 修改 代码 生成 模型 内 参数 数据 类 型 


6.2.2 设置 IDE 与 模型 参数 





设置 IDE。 选 择 模型 菜单 项 Tools 一 Utilities for Use with TASKING(CR) IDE-~Add 


Embedded IDE Link Configuartion to Model… , 为 模型 添加 IDE Link 选项 。 


选择 模型 菜单 项 Tools 一 Utilities for Use with TASKING(R) IDE-~Target Prefer- 


ences, 选 择 C166 选项 ,设置 其 目标 选项 ,如 图 6. 2.4 所 示 。 





Target Preferences Configuration Selection 






| Please choosea configuration descriptior' 


*Last edied configuration 
| 上 Create new configuration 

















6.2.4 选择 C1656 选项 


选 定 C166 目标 后 ,需要 在 弹出 的 Embedded IDE Link Target Preference 对 话 框 中 进 一 


步 配 置 所 需 文件 的 路 径 ,如 图 6. 2.5 所 示 。 


指定 CrossViews_Pro_ 下 xecutable、DOL_File、EDE_Executable 这 3 个 文件 的 位 置 , 与 
TASKING 的 安装 目录 有 关 , 例 如 用 D:\Program Files\TASKINGNc166 v8. 8rl 替换 掉 一 


ENTER_TASKING_PATH> ,如 图 6. 2.6 所 示 。 


"300。 
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图 6.2.5 设置 IDE Link 


Confoguratior_l 


ta5king.7asJingS_Corfiguraticn 


Configuration_Descnipticn 《166 

CrossView_pro_Corfiguratrcn taskingCrossViaw_prc_Configuraticn | 
Cros5sVWiew_pPro_Executable Dxprogram FilesNTASXINGVc156 vB.Brlbinxfw166.exe 诡 1 
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Reser tD Defaut OK 


6.2.6 修改 路 径 


MATLAB R2010a 版 所 指定 的 TASKING EDE for C166 版 本 为 v8. 7rl ,而 TASKING 
网 站 只 提供 v8. 8rl 试用 版 软件 下 载 。 由 于 MATLAB R2010a 不 支持 v8. 8rl 版 软件 ,因此 需 
对 R2010a 软件 中 有 关 C166 的 个 别 文件 做 一 些 修 补 。 请 用 户 登 录 北 京 航空 航天 大 学 出 版 社 
“下 载 中心 ? 下 载 经 过 修改 的 EDE 文件 ,然后 替换 matlabroot:NR2010aNtoolboxNrtwNtargetSsN\ 
taskingNtasking\default_project_optionsNc166 中 的 EDE 文件 。 

注意 :此 方法 仅 供 学 习 本 书 之 用 ,如 果 运 用 于 实际 项 目 开 发 ,请 读者 安装 MathWorks 公 
司 指定 的 正版 TAKSING EDE 软件 。 

设置 模型 参数 。 打 开 模 型 的 参数 设置 对 话 框 ,在 Solver Options 界面 ,设置 求解 器 为 定 步 
长 离散 求解 器 ,在 Solver 下 拉 列 表 中 选择 discrete 选项 \. 步 长 使 用 默认 的 auto, 也 可 自行 指定 ， 
如 图 6. 2.7 所 示 。 


Solver options 


T7pe; [Fixed-step 


ae | Solver: | discrete_(no_contiyruous States) >j 


0. 2 


Fixed-step size (furdamental sample time): 


6.2.7 求解 器 设置 


醒 : 基于 模型 的 设计 一 盖 MCU 篇 


在 Hardware Implimentation 界面 ,设置 器 件 类 型 为 C16x, 如 图 6. 2. 8 所 示 。 
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图 6.2.8 选择 芯片 
在 Real-Time Workshop 界面 ,设置 TLC 文件 为 c166. tic, 如 图 6. 2.9 所 示 。 


Target selectIon 


System target file: cl66.tlc [Browse,.。 
Larguage: 
Descrilptior; Target Support Package (for tise With Infineon C166) 


图 6.2.9 设置 TLC 文件 
在 Report 界面 , 勾 选 所 有 复 选 框 ,便于 后 期 检查 及 跟踪 ,如 图 6. 2. 10 所 示 。 
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局 Code-to-model 


Model-to-code [conteure 


Traceabilty Report Contents 


尽 Launch report automatically 


局 Elminated / virtual blocks 

尺 Traceabie Simuljink blocks 

Yi Traceable Statefiow objects 

以 Traceable Embedded MATLAB functions 


图 6.2.10 报告 界面 设置 


6.2.3 处 理 器 在 环 测试 (PIL) 


本 实例 在 2010b 版 中 可 能 会 出 现 一 些 问题 ,对 于 初学 者 来 说 不 太 好 解决 ,因此 推荐 在 
Matlab R2010a 版 本 中 测试 ,下 面 的 实例 演示 就 是 在 2010a 版 中 完成 的 。 

在 Embedded IDE Link 界面 中 ,目标 配置 文件 应 选 为 c166 ,Build action 下 拉 列 表 中 选择 
Create and Build Application Libaray 选项 ,如 图 6. 2. 11 所 示 。 


Build Configuration 





Build actiorm: [create and Bulld Application Project | 
Target Preferences Configuration [Cl166 mi; 
四 Mad buila diresctoxy suffix 





En RES 


Build directory SuEEIX; 


图 6.2.11 IDE 设置 
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完成 上 述 设 置 后 ,在 模型 的 参数 设置 对 话 框 的 Embedded IDE Link 界面 中 选择 PIL 验 
证 ,如 图 6. 2. 12 所 示 。 


Processor-1irrthe-Loop (PIL) Verification 


yi Configure model to build PIL algorithm object code 





PIL block action: Create PIL block，then build and_ download PIL_application 





园 6.2.12  PIL 设置 
单 击 模型 工具 栏 的 按钮 图 ,生成 PIL 模块 ,如 图 6.2. 13 所 示 。 





EC_maotcr_reil 


6.2.13  PIL 模块 
用 该 PIL 模块 替换 图 6. 2. 1 所 示 的 电动 机 控制 模型 ,建立 PIL 功能 验证 模型 。 需 要 注意 
的 是 输入 端口 的 数据 类 型 应 设 为 uint8 ,一 般 和 PIL 模块 相 匹 配 。 在 Pulse Grnerator 模块 后 ， 
需 添 加 数据 类 型 转换 模块 ,将 double 转化 为 uint8 型 ,在 Light Bulb 模块 前 ,应 添加 数据 类 型 
转换 模块 ,将 uint8 型 数据 转换 为 double 型 ,如 图 6. 2. 14 所 示 。 
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bata Type Conversicn5 
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Light Bulb 
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Data Type Conversicon4 


Light Bulb1 
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Data Type Conversion3 
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Data Type Conversion2 


Light Bulb3 
E 


Data Type Conversion1 





Constant1 


Constsnt2 


Pulse “Data Type Conversicn 
Generator DC_motor_5eil 





Light Bulb4 


图 6.2.14 处 理 器 在 环 测试 (PIL) 


运行 PIL 测试 ,输出 端 Light Bulb 的 变化 规律 与 功能 验证 模型 相同 。 验 证 了 针对 具体 硬 
件 Cl166 ,自动 生成 的 骨 人 式 C 代码 的 正确 性 ,如 图 6.2.15,. 图 6.2.16 所 示 。 
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6.2.15 仿真 结果 
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图 6.2.16 仿真 结果 


同时 ,在 CrossView Pro C166/ST10 中 可 以 观察 到 模拟 处 理 器 的 堆栈 ,存储 器 等 值 , 如 图 6. 2. 17 
所 示 。 
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图 6. 2. 17 “CrossView Pro C166/ST10 界面 
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6.2.4 代码 的 自动 生成 


再 次 打开 模型 参数 设置 对 话 框 , 在 Embedded IDE Link 界面 中 将 PIL 验证 关闭 , 单 击 模 
型 工具 栏 的 按钮 钢 , 生 成 模型 代码 并 给 出 了 代码 生成 报告 ,如 图 6. 2. 18 所 示 。 
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图 6.2.18 代码 生成 报告 


系统 会 自动 打开 TASKING EDE 开发 环境 ,创建 工程 ,并 编译 调试 ,最 后 生成 HEX 文 
件 , 如 图 6. 2. 19 所 示 。 
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图 6.2.19 TASKING 工程 


， 汪 基于 模型 的 设计 一 MCU 篇 


生成 代码 后 ,利用 MiniMon 软件 将 目标 板 和 PC 通过 如 拟 串 口 连接 ,可 以 直接 向 目标 板 


烧 写 程序 。 
MiniMon 软件 可 在 http://www.infineon. comy/ 中 下 载 。 打 开 网 页 , 单 击 Product Cate- 


gories 中 的 Microcontrojllers 一 Development Tools， Software and Kits, 如 图 6. 2. 20 所 示 。 
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6.2. 20 ” Microchip 网 页 
在 新 页 面 中 选择 C166/XC166 Development Tools and Software 即 可 下 载 Minimon 。 


按 提示 安装 好 MiniMon , 接 下 来 在 MATLAB 命令 行 中 输入 cl66utils ,在 弹出 的 Target 
Support Package Utilities for Use with C166 对 话 框 中 进行 配置 ,如 图 6. 2. 21 所 示 。 
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图 6.2.21 目标 支持 工具 选择 
选择 Target Perferences 选项 ,然后 在 Target Support Package Target Preferences 对 话 
框 中 指定 MiniMon 的 路 径 , 如 图 6. 2. 22 所 示 。 


| 芭 Target Support Package Target Preferences 一 马 1 1 










Dxprogram Piles\MiniMon 


_Resetto Defaukt | | OK || cancel | Help | 






6.2.22 指定 路 径 
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如 果 用 户 使 用 的 不 是 指定 的 目标 开发 板 , 则 还 需要 根据 硬件 的 实际 情况 对 代码 进行 一 定 
的 调整 。 

在 TASKING 工程 的 Source Files 中 打开 c166_main. cy, 如 图 6. 2. 23 所 示 。 可 以 发 现代 
码 还 需要 用 户 根据 实际 的 硬件 连接 情况 对 代码 进行 一 定 的 调整 ,例如 设置 输入 /输出 端口 ,对 
主 函 数 进 行 微调 等 ,具体 可 参考 5. 3. 2 节 的 内 容 。 
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图 6.2.23 修改 代码 


代码 修改 完毕 后 单 击 TASKING EDE 工具 栏 按钮 ,打开 工程 选项 窗口 ,如 图 6.2. 24 所 
示 , 在 Linker->Output Format 界面 中 , 勾 选 Intel Hex records 复 选 框 。 
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6.2.24 设置 输出 HEX 文件 
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再 单 击 工具 栏 按钮 名 , 重 编译 工程 ,如 图 6. 2. 25 所 示 ,窗口 下 部 的 信息 显示 已 成 功 生 成 
HEX 文件 ,可 以 加 载 到 硬件 上 运行 了 
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图 6.2.25 编译 TASKING 工程 
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第 / 章 
基于 Simulink 模块 的 dsPIC 单 户 机 开发 


前 面 几 章 讲 述 了 模型 代码 加 手工 代码 的 方式 ,开发 单片机 的 新 技术 .不 过 这 种 方法 也 存在 
重复 编写 器 件 配 辕 代 码 的 问题 。 为 了 加 快 项 目的 开发 速度 和 避免 不 必要 的 重复 劳动 , Micro- 
chip 公司 针对 dsPIC30 和 dsPIC33 DSC 等 器 件 ,提供 了 一 套 接口 兼容 的 配置 和 运行 时 外 设 模 
块 集 -一 MATLAB Plug-in blockset。 它 可 以 使 MATLAB/ASIMULINKV/Stateflow 与 MAT- 
LAB Plug-in blockset/MPLALD IDE 无 缝 连接 ,利用 Real-time Workshop Embedded Coder 代 
码 生成 工具 ,自动 生成 应 用 的 实时 藤 入 式 C 代码 。 可 极 大 地 提高 工作 效率 和 降低 开发 成 本 ， 
同时 也 可 降低 了 运用 dsPIC3x DSC 器 件 开发 工程 师 的 门 伏 。 下 面 对 MATLAB Plug-in 
blockset 作 一 简单 介绍 。 

模块 集 的 主要 特性 : 

(1) 模块 适用 于 dsPIC3x 系列 的 所 有 外 设 。 

(2) 可 通过 "ccCall "模块 方便 地 集成 经 过 验证 CC 代码 。 

(3) 从 MATLAB 环境 中 构建 环境 配置 。 

版 本 2.0 的 新 增 功 能 : 

(1) 支持 dsPIC30F 系列 器 件 。 

(2) 电动 机 控制 算法 库 。 

(3) 缺陷 修正 和 改进 。 

(4) 演示 版 一 一 免费 评估 版 。 

(5) 与 MPLAB 的 MATILAB 揪 件 更 好 地 集成 在 一 起 。 

(6) 与 从 R2007a 到 R2009b 的 所 有 MATLABH 版 本 兼容 ,不 过 也 支持 R2010a、R2010b 版 
(作者 安装 的 版 本 是 R2010b) 。 模 块 适 用 于 dsPIC3x 系列 的 所 有 外 设 。 

本 章 的 主要 内 容 

@ MPLAB 开发 工具 简介 。 

@ dsPIC 外 半 驱 动 模块 介绍 及 应 用 。 

@ 无 对 应 驱动 模块 时 的 应 用 。 
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7.1 MPLAB 让 入 式 开发 环境 及 工具 


MPLAB IDE 是 Microchip 公司 开发 的 基于 Windows 操作 系统 的 集成 开发 环境 ,适用 于 
PICmicro MCU 系列 和 dsPIC 数字 信和 号 控制 器 的 开发 。 同 时 ,MPLAB IDE 还 将 其 他 Micro- 
chip 工具 集 和 第 三 方 软件 集成 到 一 个 图 形 用 户 界 面 之 中 。 其 主要 功能 如 下 : 

(1) 使 用 内 置 的 编辑 器 创建 和 编辑 源 代码 。 

(2) 汇编 .编译 和 链接 源 代 码 。 

(3) 通过 使 用 内 置 的 软件 模拟 器 观察 程序 流程 ,或 者 使 用 在 线 仿真 器 或 在 线 调 试 器 以 
实时 方式 观察 程序 流程 来 调试 可 执行 逻辑 。 

(4) 用 软件 模拟 器 或 仿真 器 进行 时 序 测 量 。 

(5) 查看 Watch 窗口 中 的 变量 。 

MATLAB/Simulink device blocksets 问 Simulink 模型 库 中 添加 了 dsPIC 模块 。 这 些 模 
块 既 可 以 单独 使 用 ,也 能 和 Simulink 模块 混合 建 模 ,并 通过 Real-time Workshop Embedded 
Coder 自动 生成 嵌 人 式 实时 C 代码 ,再 经 MPLAB IDE 实现 敌人 式 应 用 的 基于 模型 设计 的 
开发 。 

MPLAB C30 Compiler 是 针对 16 位 dsPIC 芯片 dsPIC30 和 dsPIC33 设计 的 高 度 优 化 的 
编译 器 ,通过 MPLAB C30 Compiler 或 其 他 第 三 方 编译 器 可 以 用 忆 语言 实 现 dsPIC 开发 。 


7.1.1 软件 的 下 载 和 安装 


用 户 在 浏览 器 地 址 栏 中 输入 网 址 :http://www. microchip. comystellent/idcplg? IdcSer- 
vice 一 SS_GET_PAGE&nodelId = 1406&dDocName = 一 en019469& part 王 SW007002, 打开 
MPLAB 下 载 网 页 ,如 图 7. 1. 1 所 示 。 


MPLAB Software ” 
Associated Files and Release Notes 
Release Notes forMPLAB IDEY9 .56 





一 -一 -一 一 = 一- 一- 一 一 一 一 一 > 一 一 一 一 一 一 一 一 一 一 一 


Eeeas 





Tite Date Pubiished Size BDIL 
MESSMMPLINISUSsers Guide 4iBj2009 3'52:41PM 2896 KB 昌 
MPLAB Ass8 TiLinker and UtilitiesforPic24MCUs and dsPle DSGs Users Guide 1262010 10.16-32 AU 1981 KB 居 
MPLaBIDEUsers Guide H20/2009 12.09:31P 天 4232KB 鱼 
Tha suMPLABIPEDebug Tool at al13/2010 于 坊 .00 PH 17f kB 个 


图 7.1.1 MPLAB 下 载 网 页 


在 网 页 下 方 单 击 链接 MPLAB IDE v8. 56 Full Release Zipped Installation 和 MATLAB Device 
Blocks for dsPIC DSCs 即 可 下 载 MPLAB IDE 和 MATLABV/Simulinkdevice blocksets。 

用 户 如 果 使 用 过 MPLAB 的 较 早 版 本 ,或 将 V8. 53 版 本 安装 在 非 默认 路 径 下 ,请 首先 将 
其 印 载 ,不 然 在 后 续 使 用 过 程 中 ,系统 有 可 能 无 法 定位 到 需要 的 文件 。 

单 击 windows 开始 菜单 ,选择 控制 面板 一 印 载 程序 ,在 列表 中 选择 MPLAB Tools V8. 53 
选项 , 单 击 “ 印 载 ” 按 钮 ,将 其 完全 移 除 ,如 图 7.1. 2 所 示 。 


0 
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乡 如 ” ” 宴 哉 “更改 


~ 和- 
各 称 发 布 看 安装 时 |“ 
| 同 MpLaAa Tools v8.53 Microchip Technology Inc. 2010/8 
久 NVIDIA Display Control Panel NVIDIA Corporation 2010/8 
久 NVIDIA Drivers NVIDIA Corporation 2010/E 
SNVIDIA physX NVIDIA Corporation 2010/E 
ObjectDock plus 2010/E - 
症 人 偶 上 
机 Microchip Technology Inc. 产品 后 去 : 8.53 
只 N 


丙 惑 钴 十; http://suppormicrochip.comy/scripts/sbeweb.dilyextern.. 


图 7.1.2 外 载 早期 版 本 的 MPLAB 
1. 安装 MPLAB IDE 


打开 MPLAB IDE 安 程序 ,按照 安装 向 导 的 提示 进行 安装 ,在 Setup Type 对 话 框 中 尽量 
点 选 Complete 单 选 按钮 ,如 图 7. 1. 3 所 示 。 


Setup Type 
Selecl he setup pe lo install 


Please sect 3 Satup lype 


本 Compiaie 


瑶 ptogram leatunes wdl be inslaled |Pequres the mosl disk Space 


Duewom 


Select whuch Pogian lealuaes you wani instaled Recommended fa 
可 vanced usels 





图 7.1.3 MPLAB 安装 界面 


如 果 点 选 了 Custom 单 选 按钮 , 则 在 Select Features 对 话 框 中 应 选择 MPLAB IDE Tools 
的 MATLAB 选项 ,以 便 能 够 使 用 MATLAB Plug-in ,如 图 7.1.4 所 示 。 


MPpLA B7Tocls ”基本 3 

避 Select Featuwres | 
ra AAAMcnocHip| 
Select the fsstuses you wantio matal and deselsctthe faaheess you do nol wantio nat 砚 


三 蔚 MPLABIDETook 2] Descipion 
| 醒 MPLAB Target Appkcation |rvDut Display | Select the mictoconiroler 
中 Data Mornaor and Conhol iniesface groupsJOU Ge Ung 
YANS08 ADIM Tunmg Inielface 
WRTOS Viewer 
wwMATLAB 


YGmpel PCLin/MISRA Plug 
VSMPS GUls 
YLCD Desionet 


gl 


843 76 MB of space ieqused on the[C dive 
165396 21 MB of space avaisble on ihe C dve 





二 -， 基于 模型 的 设计 一 一 MCU 篇 


在 Choose Destination Location 对 话 框 中 选用 默认 路 径 , 不 要 作 任 何 修改 。 其 他 对 话 框 
不 用 作 修 改 , 单 击 “ 下 一 步 ? 按 钮 ,如 图 7. 1. 5 所 示 。 





Choose Destinahon Locaion 
由 Selecliolder where Setup wa insial fles 


SetuPp wa instal MPLAB Tooks v6.53 mm he iolowng folder 
Toinstal lo lthis folder ckck New To mstallio a diiferentfolder click Biowse and seleclt 
lder 


Destimalion Foldsr 
CAVProgram Fles\WMicfochep\ 


7.1.5 MPLAB 安装 界面 


2， 安装 C30 Compiler 


打开 C30 Compiler 安装 程序 ,按照 安装 向 导 的 提示 进行 安装 ,在 Setup Type 对 话 框 中 选 
择 Complete 选项 ,如 图 7. 1.6 所 示 。 


Salecl the setup type io mslal 
Please select a setup Upe 


总 Complele 
碘 点 | Ptogram features wii be installed |Requwes lihe mosl disk space.] 


[Custom 


5eleci which ptogram Ileatures you want nstalled 有 ecommended for 
advanced users 


图 7.1.6 C30 编译 器 安装 界面 


在 Choose Destination Location 对 话 框 中 选用 默认 路 径 ,不 要 作 任 何 修改 ,如 图 ?7.1.7 
所 示 。 
下 面 安 装 程序 会 询问 是 否 同意 修改 环境 变量 和 注册 表 以 便 MPLAB IDE 能 够 识别 到 C30 
Compiler, 单 击 “ 是 ?按钮 ,允许 其 修改 。 其 他 对 话 框 不 用 作 修 改 , 单 击 “ 下 一 步 ? 按 钮 ,如 图 7. 1. 8、 
图 7. 1.9 所 示 。 
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Select ioldes where Selup will mw 可 月 es 


Selup wal metalMPLAB Car dyPIC DSCs and PIC24 MCUs in the foloweg lokder 
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图 7.1.7 “C30 编译 器 安装 界面 


SR 一 一、 -一 二 we 
站 Modify PATH? IE { 

| 

This instailer can medify your 5ATH ervirconmment variable to inclode': 上 | ， 5 _ 日 

CApregram filiss\WMicrechipVMPLAS C30\bin | | | Would you llke this installerto ed 扩 OUT fg | | 

上 De you wart 引 e setup Program to modify your ervironrmene7 | | 5 that the MPLAS iDE car use this compiler7 











图 7.1.8 C30 编译 器 安装 界面 图 7.1.9 C30 编译 器 安装 界面 


3. 安装 MATLAB-Blocksets 


此 处 下 载 的 MATLAB Blockset 是 V2. 10 版 ,如 果 用 户 机 器 中 安装 了 其 他 版 本 的 MAT- 
LAB Biockset, 有 可 能 和 V2. 10 版 间 会 产生 一 些 冲突 ,这 里 仅 就 V2. 10 版 的 MATLAB 
Blockset 进行 讨论 。 

打开 MATLAB Blocksets 安 程序 ,按照 安装 向 导 的 提示 进行 安装 ,在 Choose Destination 
Location 对 话 框 中 选用 默认 路 径 ,不 要 作 任 何 修改 ,如 图 7. 1. 10 所 示 。 

MPLABS MATLAS Socksets for dspiC DSCs - InstaliShield Ward 


Choose Deszlimation Location 
Selecl folder whese sclup wd nsiai hies 
1 1 
| Changas - 


Inaal MPLAB MATLAB Blocksetsfor dsPIC DSCs to | 
昌 
昌 
问 





| 
和 
4 
| 
4 





SR CAWMicochpVMPLAB IDENTocke\MATLAB 


图 7.1.10 MATLAB-Blocksets 安装 界面 


恒 - 基于 模型 的 设计 一 一 MCU 篇 


由 于 这 是 较 早 期 的 MATLAB Blocksets, 其 支持 的 最 高 版 本 MATLAB 是 R2009b ,但 对 
R2010b 版 也 仍然 兼容 ,此 处 匀 选 R2009b 复 选 框 。 其 他 对 话 框 不 用 作 修 改 , 单 击 “ 下 一 步 ? 按 
钮 ,如 图 7.1. 11 所 未 。 


MPLAB MATLAB Blocksets for dsPIC DSCs - Installshieid Wizard 


| Select MATLAB Version 
Select the version of MATLAB you wa be usina. 


Dick acheckbox lo choose a Yerslom 

















图 7.1.11 MATLAB-Blocksets 安装 界面 


安装 完 MATLAB Blockset 后 ,dsPIC 模块 并 没有 立即 添加 到 Simulink 模块 库 中 ,用 户 还 
需要 在 MATLAB 环境 中 进行 添加 。 

打开 MATLAB, 并 将 当前 目录 (人 (current folder) 设置 为 Microchip root:\MPLAB IDEA\ 
Tools\MATLAB\dsPIC_Matlab ,在 当前 目录 下 的 文件 列表 中 可 以 发 现 一 个 Install dsPIC _ 
Matlab. p 文件 ,如 图 7. 1. 12 所 示 。 


长 马 3a 门 Fe 人 :< 


生 ; Contents.m 
2 info xm| 


S， TUTFTC 人 5 
的 Contents.rm 
三 info.xml 


JJ Readme.html 


曲 1 
的 remove_dsPIC_Matlab.p | At 


中 Readme.html 





加 Versionbk 洗 remove_dspICN Create Zip fiie 
3 | Version.tx Rena 
[不 Star Ready 
7.1.12 定位 到 安装 目录 图 7.1.13 运行 Install dsPIC_Matiab.p 文件 


全 友 0 
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命令 行 中 会 出 现 如 下 信息 


Target for Microchip(IM) dsPIC 2.10 is Installed and ready to Use. 


这 时 再 打开 Simulink 模块 库 浏 览 器 ,就 可 以 看 到 安装 的 模块 了 ,如 图 7.1.14 所 示 。 


Lbraries 中 | LarsSry Target fr MicrochipfTV) dsPIC | 


三- 和 | 国 和 四 


d5PIC DSPlb 


dsFIC QIMatnLibp 
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… 吧 PRIC DSPib 
-dpPIC OhNathnLib 
~ dPIC Run Time Library 
| 六 凤 PC33fDMCAIgos 
| 一 daPIC Confguration 
上 野 vehice Network Toobox 
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机 和 XPC 们 T9ef 一 | 





d5PIC Run Time [上 比 f89y7 


dsPIC33f DRIC AIGos 





dPIC Configuraticn 


图 7.1.14 dsPIC 模块 库 


7.1.2 利用 MPLAB IDE 及 Proteus VSM 进行 虚拟 硬件 调试 


MPLAB IDE 集成 了 大 量 的 调试 工具 , 既 包 括 MPLAB ICD 等 仿真 器 ,也 能 使 用 Proteus 
软件 进行 虚拟 硬件 调试 。 


打开 MPLAB IDE, 选 择 菜 单 栏 的 Debugger~>Select Tool -~ Proteus VSM 即 可 在 
MPLAB IDE 中 打开 Proteus VSM 界面 ,如 图 7.1.15 .图 7.1.16 所 示 。 


Select 和 少 





No 


Clear Memory 上 VIProteus VSM | 
站 了 村 2 MPLAB ICD 2 
民 遇 广 地 
3 PICKE 3 
AAAFNTISAR 
必 BWPLAEB CE 40600 
门 言 ! 
RE 5 MPLAB STM 
二 和 6.MPLAB 1CE 2000 
了 7 REAL ICE 
sa 8 PICkt 2 
9 MPLAB 1CD 3 
Breakpolnts... F2 10 PiC32 Starter Ki 
Start Simulation Fl12 光 aer X(S 
Stop Sirnujatiecr CE 人 于 2 | ] | 
图 7.1.15 选择 Proteus VSMI 调试 工具 
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图 7.1.16 调试 界面 


1. 绘制 原理 图 


作者 目前 使 用 的 Proteus ?7.7 版 本 , 仅 支 持 dsPIC33 系列 中 的 一 部 分 芯片 ,不 过 Labcenter 
公司 即将 推出 的 Proteus 8. 0 版 本 将 会 支持 更 多 dsPIC33 芯片 ,开拓 虚拟 硬件 测试 范围 。 

本 例 利 用 dsPIC33FJ12GP201 芯片 搭建 一 个 能 够 点 亮 发 光 二 极 管 的 最 简 系 统 ,演示 如 何 
在 MPLAB IDE 中 使 用 Proteus VSM 进行 虚拟 硬件 调试 。 

参考 第 5. 1 节 的 内 容 , 不 难 搭建 出 图 7. 1. 17 所 示 的 原理 图 。 图 中 仅 包含 驱动 电路 工作 所 
必须 的 电源 .晶振 和 复位 电路 。 
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DSPIC33FJI2CP201 
PACKAGSE=SO18W 
















7. 1. 17 “Proteus 原理 图 


Proteus 中 ,该 元 件 封装 将 13、17、18 引 脚 隐藏 了 ,因此 未 显示 出 VDD, VSS。 双 击 
dsPIC33FJ12GP201 芯片 ,打开 其 属性 对 话 框 ,如 图 7. 1. 18 所 示 。 


“316 区 一 一 Et ， 
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图 7.1.18 芯片 属性 设置 界面 
单 击 对 话 框 右 侧 的 Hidden Pins 即 可 查看 隐藏 引 脚 的 连接 情况 。 由 图 7. 1. 19 可 知 ,隐藏 
引 脚 已 经 与 VDD,VSS 相连 。 


2. 建立 MPLAB 工程 
打开 MPLAB IDE ,选择 菜单 栏 上 的 Project-~>Project Wizard ,在 弹出 的 工程 向 导 提 示 下 ， 
可 以 快速 新 建 一 个 MPLAB 工程 ,如 图 7.1. 20 所 示 。 
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图 7.1.19 隐藏 管 脚 页 面 图 7.1.20 选择 工程 向 导 


在 工程 向 导 的 Step one 对 话 框 中 指定 芯片 dsPIC33FJ12GP201 ,如 图 7.1. 21 所 示 。 





Selact a device 





图 7.1.21 指定 芯片 
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在 工程 向 导 的 Step two 对 话 框 中 ,在 Active Toolsuit 下 拉 菜 单 中 选择 之 前 安装 过 的 
MPLAB C30 Toolsuit。 然 后 需要 在 Location 中 为 Toolsuit 的 每 一 个 组 件 指 定 路 径 , 不 然 
MPLAB IDE 无 法 定位 到 这 些 组 件 , 如 图 7. 1. 22 所 示 。 
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图 7.1.22 选择 工具 
在 工程 向 导 的 Step Three 对 话 框 中 ,确定 工程 的 名 称 和 保存 路 径 ,如 图 7. 1. 23 所 示 。 


一 一 一 一 


Step Three: 
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图 7.1.23 确定 名 称 及 路 径 


在 工程 向 导 的 Step Three 对 话 框 中 ,可 以 直接 将 已 存在 的 文件 添加 到 工程 中 ,如 果 没 有 
需要 添加 的 文件 , 单 击 “ 下 一 步 ? 按 钮 ,如 图 7. 1. 24 所 示 。 
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上 dd existing files to 7 了 oOUr Project 
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图 7.1.24 向 工程 添加 文件 
工程 建立 后 会 同时 生成 工作 空间 ,保存 到 同一 目录 下 即 可 ,如 图 7.1. 25 所 示 。 


合 斌 By 图 ~ 
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图 7.1.25 保存 工作 空间 


编写 闪烁 灯 程序 。 
单 击 工具 栏 按钮 D ,在 编辑 窗口 中 编写 以 下 程序 : 


# include < p33FJ12GP201.h> 
# define uint unsigned int 
void delay(uint al) // 延 时 程序 
{ 

Uintxy Yi 

for(x= aix> 0;x 一 ) 

for(yY= 100;Y> 0;Y 一 ); 

} 
Volid main() 


人 
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TRISBbits.TRISBO = 0; 1// 设 置 RB0 口 为 输出 
while(1ly) 
{ 
PORTBbits.RB0O = 1; // 点 亮 LED 
delay(1000) ; 
PORTBbits. RBO = 0; // 熄 灭 LED 
delaV(1000) ; 
} 


} 


单 击 工 具 栏 按钮 罩 保 存 文件 为 . c 格式 。 在 弹出 对 话 框 中 色 选 Add File To Project 复 选 
框 并 保存 ,直接 将 文件 添加 到 工程 的 Source File 中 ,然后 向 Header File 目录 中 添加 芯片 头 文 
件 p33FJ12GP201.h, 如 图 7.1.26 所 示 。 
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7.1.26 MPLAB 工程 


为 了 提高 dsPIC 芯片 的 灵活 性 和 可 靠 性 ,Microchip 公司 为 其 设计 了 一 些 特殊 功能 ,如 看 
门 狗 .代码 保护 JTAG 边界 扫描 接口 .在 线 串 行 编程 和 在 线 仿 真 。 为 了 控制 芯片 和 使 用 这 些 
特殊 功能 ,需要 用 户 对 其 配置 位 进行 适当 调整 。 

在 菜单 栏 中 选择 Configure~>Configuration Bits… 命令 ,打开 配置 位 对 话 框 , 如 图 7.1. 27 





Window Help 所 示 。 
Select Device.… 在 配置 位 对 话 框 中 取消 色 选 Configuration Bits set in 


Wi 
Coreenee- code 复 选 框 ,然后 用 户 就 可 以 在 此 处 修改 配置 位 了 。 如 果 
用 户 对 配置 位 比较 熟悉 , 则 应 选择 Configuration Bits set in 


ID Memory,..， 


Settings.… code 命令 ,并 直接 在 代码 中 使 用 _Config() 进 行 修改 。 本 例 
并 未 使 用 到 芯片 的 特殊 功能 ,使 用 默认 设置 即 可 。 关 于 配 
图 7.1.27 配置 位 置 位 的 介绍 可 参考 芯片 的 数据 手册 ,如 图 7.1. 28 所 示 。 
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图 7.1.28 配置 位 设置 页 面 
单 击 工具 栏 按钮 他 编译 程序 ,输出 如 下 信息 ,如 图 7.1. 29 所 示 。 
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图 7.1.29 编译 MPLAB 工程 


3. 调 试 
选择 MPLAB IDE 菜单 栏 的 Debugger-~>Select Tool-~>Proteus VSM ,在 MPLAB IDE 中 
打开 Proteus 界面 。 在 Proteus 界面 中 单 击 按钮 召 打开 之 前 绘制 的 原理 图 ,如 图 7.1. 30 所 示 。 
单 击 工具 栏 右 侧 的 按钮 才 ,或 选择 菜单 栏 的 Debugger->~Start Simulation 开始 仿真 。 这 时 
调试 工具 栏 :，wenac9ee 处 于 激活 状态 。 单 击 按 钮 ,进入 全 速 运行 状态 ,可 以 看 到 二 极 管 不 
停 地 闪烁 ,如 图 7. 1. 31 所 示 。 
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7.1.30 使 用 Proteus VSM 调试 工具 
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图 7.1.31 LED 灯 闪 烁 


除 此 之 外 ,MPLAB 还 提供 了 其 他 观察 芯片 内 部 数据 变化 的 工具 ,例如 在 菜单 中 选择 view-~> 
Special Function Registers, 可 以 实时 观察 芯片 的 特殊 功能 寄存 器 的 值 , 发 生变 化 的 寄存 器 以 红色 标 
出 ,如 图 7.1. 32 所 示 。 


SPI1SIATE 
SPIJCCNM1 
SPBI1ICON2 





图 7.1.32 特殊 功能 寄存 器 
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若 选择 view 一 Disassenbly Listing 选项 ,可 以 看 到 程序 的 反 汇 编 指令 ,并 以 箭头 标注 下 一 
步 执行 指令 的 位 置 , 如 图 7. 1. 33 所 示 。 


TITRISBPizSs _IRISBO 
scJle-p exog2ece Yo 





图 7.1.33 反 汇 编 指 令 列 表 


7.1.3 dsPIC 外 围 驱 动 模 块 简介 


MATLAB/Simulink device blocksets 与 dsPIC 芯片 的 外 围 张 动 模块 一 一 对 应 ,用 户 可 以 
通过 这 些 模 块 创 建 模型 ,直接 由 概念 生成 可 执行 的 代码 。 

Embedded Target for the Microchip dsPIC DSC 集成 了 MATLAB/Simulink 和 MPLAB 
IDE 工具 ,通过 RTW 生成 的 C 代码 与 MPLAB IDE 达到 Simulink 模型 的 基于 C 的 嵌入 式 实 
时 实现 。 

模块 简介 如 下 : 

(1) ADC Config: 模 数 转换 配置 模块 。 该 模块 可 设置 模拟 量 的 输入 端口 .输出 数字 量 的 格 
式 .转换 结果 寄存 器 .A/D 控制 寄存 器 等 ,驱动 芯片 的 A/D 设备 正常 工作 。 

(2) Write Port Output: 写 人 输出 端口 模块 。 该 模块 可 指定 将 数据 写 人 到 哪 一 个 端口 , 即 
能 按 位 指定 ,也 能 按 字 节 指 定 端 口 。 

(3) dsPIC33FXX Main:dsPIC33FXX 芯片 配置 模块 。 每 个 基于 dsPIC 芯片 的 模型 都 需 
要 使 用 该 模块 。 它 和 芯片 的 配置 位 相对 应 ,例如 设置 晶振 .计时 器 等 。 

(4) Port Config :端口 配置 模块 。 该 模块 指定 端口 的 输入 /输出 状态 , 既 能 按 位 指定 ,也 能 
按 字 节 指定 。 

在 MATLAB/Simulink device blocksets 的 安装 目录 下 有 更 加 详细 的 帮助 文件 。 如 果 用 
户 安装 MPLAB IDE 和 MATLAB/Simulink device blocksets 时 选择 了 默认 目录 , 则 可 在 C 认 \ 
Program Files\MicrochipP\MPLAB IDENTools\MATLAB\NdsPIC_MatlabN\docNhelp 目录 下 找 
到 每 一 个 模块 的 HTML 格式 的 帮助 文件 ,例如 打开 文件 dsPIC ADC Read. html, 则 出 现 
图 7. 1. 34 所 示 的 帮助 信息 。 
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ADC Read for dsPIC Devices 


ADC Read 
Read from specifted buffer of ADC peripheral. 
Biock 


医 三 


ADC Read 


Description 
Configure any ADC of a dsPIC dewce to read the data available ai ADC read bufier. 





Ports 

Input 

None 

Output 

Data of the type uint16 will be available at output port of the blcck. 


7.1.34 ADC Read 模块 帮助 信息 


7.2 dsPIC 处 围 驱 动 模块 应 用 


7.2.1 数 模 转换 实验 


ADC Read 模型 实现 了 控制 dsPIC33FJ12GP202 的 片 内 ADC ,将 模拟 电压 输入 转换 为 数 
字 量 输出 的 功能 。 本 模型 用 到 了 dsPIC Configuration 模块 库 中 的 dsPIC33f{XX Main 、ADC 
Config 和 Port Config;dsPIC Run Time Library 模块 库 中 的 ADC Read 和 Write Port Outpnut 


模块 。 建 立 图 7. 2. 1 所 示 的 模型 ,并 将 其 命名 为 adc. mdl。 


Port Config dsPIC33fxx Nain ADC Config 








ADC Read Write PortoOutput 


图 7.2.1 ADC 模型 
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1. 模块 设置 


双击 ADC Read 模块 ,打开 设置 界面 。 选 择 片 内 1 号 ADC, 由 buffer0 读 出 数据 ,输出 数 
据 类 型 为 uint16 ,如 图 7. 2. 2 所 示 。 

双击 Write Output Port 模块 ,打开 设置 界面 。 选 择 B 端口 ,并 具体 指定 输出 到 B 端口 的 
0 一 15 号 引 脚 ,如 图 7. 2. 3 所 示 。 


一 一 Cramn r ar 
[ 喇 Source Bliock par ameters ADC Reasd | | 最 Sink Blcck Parameters Write Port Outpwut er | 
| 


ADC Fead (nask) (linx) | Write Port (nask) (1ink) 
| ADC Read Buffer Selection for RunTins. | 1 wziee 攻 fied 《 
| By selecting the Output of 3 partlcular 《ype，the data | 和 2 9 3Dec2E26C Po 

| output 15 《7pPe CaSsY6d 《OO 《hat ty7pe， | | 
| | | 。 Parameters 
| | Paraaeters | | 


| 
| | Select Port | 了 = | 
| Select ADc ADCI | 


Write tO 35elected Piry/ 3 





Read froa ADC buffer | 四 | 
| ; Select the Pirys for egi [3:5] +o select pins 3,4 and 5 
Duxtput Datat7pe iuint16 到 [0;15] 
| | 
| 
本 ” | 1 Cancel Help - | 0OE Cancel Help | 
2 Us=tenss5ee 二 ER or - 
图 7.2.2 ADC Read 模块 设置 图 7.2.3 Write Output Port 模块 设置 


dsPIC33f{XX Main .ADC Config 和 Port Config 模块 用 于 设置 芯片 的 配置 位 和 特殊 功能 
寄存 器 ,以 确定 芯片 的 工作 方式 。 如 果 用 户 对 dsPIC 芯片 比较 熟悉 ,设置 这 些 模块 并 不 困难 。 

dsPIC33FXX Main 模块 对 应 于 芯片 的 配置 位 ,双击 打开 其 设置 界面 。 在 Oscillator Con- 
figuration 选项 卡 ,选择 芯片 型 号 为 dsPIC33FJ12GP202 ,计时 器 选择 Timer] 。 

振 功 器 选择 快速 RC 振荡 器 (Fast RC oscillator) 。 由 于 未 选用 主 振 功 器 ,其 模式 设置 为 禁 
用 (Primary Disabled) 。 

看 门 狗 和 代码 保护 功能 本 例 并 未 用 到 ,因此 Watchdog Configuration 和 Code Protect 
Configuration 选项 卡 采 用 默认 设置 即 可 (默认 为 disable 状态 ) ,如 图 7. 2.4 所 示 。 


DOscillator Configuration Watchdog Configurst2om codes Protect ConfEa8urat10mn 
“hoose the dspIC33 ;33FJ120P202 


Tinerf | TeF 





or Source Selecti00 Fast RC 0scillatof 


Fecy 【 Jnmstructiorsy/Sec = Fosc/2 ) 


Required ain Loop Tine (as) 
1 


Two-szpeed 0sclllator startup Disebled 王 
Teaperatuce ProtectIion 
Cloclk Switching and Clock Nonitoring | Both 出 sabled 


0SC2 Pin fumnction Digital IO 引 了 





Debug Communication charmel select Use PCGCIAEIDCI and PCDI7EIOD1 本 


图 7.2.4 dsPIC33FXX Main 模块 设置 


ADC Config 对 应 于 芯片 的 ADxCONx 控制 寄存 器 ,双击 打开 其 设置 界面 。 
在 ADC 选择 中 选用 1 号 ADC; 数 据 输出 格式 为 整数 在 对 齐 (JInteger(Dout 王 0000 dddd 
dddd ddddy) ) ; 


采样 时 钟 源 选 择 内 部 时 钟 源 , 时 钟 源 结束 采样 后 自动 启动 转换 (Internal counter ends 


“325 ; 


， 浊 基于 模型 的 设计 一 一 MCU 篇 


sampling and starts convertion(Cauto-convert) ) ; 


由 于 选用 单 通道 采样 ,因此 同步 采样 选择 位 无 效 ;: 使 能 ADC 采样 自动 启动 (ADC Sample 
Auto-Start) ; 

转换 的 参考 电压 分 别 设 为 VDD 和 VSSCADREF 十 王 Avdd;ADREF 一 一 Avss); 

转换 模式 选择 10 位 A/D(10 一 bit 4 一 channel ADC operation) ; 

将 AN1 设置 为 模拟 输入 通道 ,并 启用 输入 扫描 (Scan Input Selections for CH0O 十 during 
Sample A bit) ,如 图 7. 2.5 所 示 。 





ADC Select |ADC1 





output Data Forast type [ER OO 


Sample Clock Source Select | Internal counter ends sampling and starts conwersion (auto-convert) 罗 





| Simultaneous Sample Select Sanples mujltiple charmne1ls individually ln sequence ， 
区 ADC Samap1e Auto-Start 


|Comverter Yoltage Keference Configuration |ADREF+ = vdd;ADREF-=Avss ae | 


10-~bit or 12-bit Operation Mode bit ,10-bit 4-charmel ADC operation donoriordp9FRooN | 


vi Scan Jrnput Selections for CH0+ during Sanple A bit 


Enter charmels that need to be scannmned (eg:[2 5] for AN2 arnd AN5) 
[ 





图 7.2.5 ADC Config 模块 设置 


在 通道 选择 中 选择 转换 CH0O 通道 (CConverts CH0O ) 。 

在 交替 输入 选择 中 选择 只 作为 采样 A 的 输入 (use channel input for Sample A) 。 

将 AN1 设 为 通道 CHO 采样 A 的 同 向 输入 (AN1) 。 

由 于 未 选择 CH1、\CH2 .CH3 及 采样 B, 其 他 三 项 同 回 输 入 设置 位 无 效 。 

每 完成 一 次 采样 -转换 就 产生 一 次 中 断 , 读 出 转换 结果 (CSMPI 设 为 1) ,如 图 7. 2.6 所 示 。 


Select Chanmels |Conwerts CH 











| Alternate Irput Sanple Jode Select use channel input for Sanple A -一 aaa Ri 
PositiVe Input Selection for Charnmel 0 Sample A bits AN1 es RE Na ns 9 
Positlive Irput Selectior for Charmel 0 Sanmple B bits AND 。 We 和 了 Eee ea 2 








由 


Positive Input Selection for Channel 1,2,3 Sanple A Bits |CHI positive input is ANO CH2 positive _input is 下 ] 
PositiVe Input Selection for Charmel 1,2,3 Sanple B Bitzs [CH positive input is ANO0 CH2 ositiwe input 2 ~] 


unber of sanple/conversior operations before ssSS InCre&ertt Or lirterrupt generation J 人 





图 7.2.6 ADC Config 模块 设置 


在 A7/D 转换 时 钟 源 中 选择 系统 时 钟 (Clock derived from system clock) 。 


自动 采样 时 间 设 置 为 12 个 A/D 转换 周期 (12Tad) ,其 实 只 要 保证 其 不 小 于 A/D 转换 所 
需 的 最 短 时 间 要 求 即 可 。 


芯片 数据 手册 中 介绍 ,完成 一 次 10 位 A/D 转换 需要 12 个 A/D 转换 周期 ,因此 A/D 转 
换 时 间 设 置 为 12 个 A/D 转换 周期 。 


:全 2 机 
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使 能 中 断后 ,会 在 稍 后 的 生成 代码 中 出 现 -- 个 中 断 服 务 程序 框架 ,用 户 可 以 手动 添加 所 需 
代码 ,本 例 中 不 需要 使 用 ,如 图 7. 2.7 所 示 。 








ADC Comvwersion Clock Source |Clock derived 了 rom systea_clack- Wi 










Auto Sanple Tine 12 Tad 
ADC Corwersion ClLock Select bits 
12 






局 | Enable Interrupts 


Interrupt Priority 14 





图 7.2.7 ADC Config 模块 设置 


Port Config 模块 对 应 于 特殊 功能 位 TRISx, 双 击 打 开 其 设置 界面 。 选 择 端口 B, 并 将 其 
0 一 15 引 脚 设置 为 输出 状态 ,如 图 7. 2. 8 所 示 。 


最 Biock Parameters: Port Config 
| S-Function (nask) (link) 


Parameter3 


| Configure as |output 


Select Port |B 


局 Corfigure Selected Piry s 
| Select the Pirys for eg: [6] to select pin 6 
| [0:15] 


[or 了] [cmmeelaa | 





图 7.2.8 Port Config 模块 设置 


2. 模型 参数 设置 


在 模型 窗口 的 菜单 栏 选 择 Simulation 一 Configuration Parameters, 设置 模型 参数 。 在 
Solver 界面 ,设置 仿真 截止 时 间 为 inf, 设 置 求解 器 为 定 步 长 离散 求解 器 , 步 长 可 根据 需要 另行 
指定 ,或 使 用 auto, 如 图 7. 2.9 所 示 。 

Simulat ion time 
Start tiae: 0.0 Stop time: inf 


Solver options 





Type: [Fized-step |solver: |discrete (no contimuous states) im] 





Fixed-step Size (fundamental sanple time): autD 


图 7.2.9 设置 仿真 时 间 ,求解 器 


在 Hardware Implimentation 界面 ,设置 器 件 类 型 为 dsPIC, 如 图 7. 2. 10 所 示 。 
在 Real-Time Workshop 界面 ,设置 TLC 文件 为 dsPIC _stf. tlc, 如 图 7. 2. 11 所 示 。 


这 "32 7 : 


一 -1 基于 模型 的 设计 一 一 MCU 篇 


Embedded hardware (simnulation and code gereratior) Target 381ectiom 
Device Verndor: pcrochip El is | Syeto target Ti1o5 daFTIC-etfttlc LBrowse -| 
Device t7pe: | dsPIC | Language: [_. 文员 wa 


图 7.2.10 指定 芯片 


图 7.2.11 设置 tlc 


在 Report 界面 , 勾 选 所 有 复 选 框 ,便于 后 期 检查 及 跟踪 ,如 图 7. 2. 12 所 示 。 


癌 Create code generation report 这 Launch report autormatically 


Navigation 

司 Code-to-model 

殉 ModeHto-code 
Traceabilty Report Contents 

多 印 minated /virtual blocks 
Traceable Slrmulnk blocks 
Traceable 5tateflow objects 

局 Traceable Embedded MATLAB functions 


图 7.2.12 报告 界面 设置 
3. 自动 生成 代码 


完成 这 一 系列 的 设置 , 单 击 模型 工具 栏 的 按钮 多 , 即 生成 代码 ,报告 如 图 7. 2. 13 所 示 。 


Sirclud “sd 
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Contents 
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Solid adc_step(yoid) [ 司 
| 易 
| 恒 
Generated Flles # TDPT 有 Jocyr 2 ezI6610E | 旱 
[] Nodel 和 les Vintip 了 rtb_ADCRKead | 于 
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1 和 Fetion LSPIC LDOTAed SFTUED Teoel2rdnr fa 
1 rt5_RDCRead = FeadADCIUIOIIE3 TO) ea ANC PT 


| 
Back Forwerd | 


昌 丰 DFI 下 
adc_ ypes 由 


F Snpuwir5Ie dzPe 
4 LAT = vtb_ ADCReSd; 
[] Utility files ; } 





rtyRS5h | 
| “Dite inrflaTazze firmctfJonp 有 
[-] Interface files ) vod sdec_iritialisetbhoolesr T fxrstTine) 
akobuskd hb 
(void)ftrstTIne 
[Other files 
jntarruptsc zeAXESEYSEEEI Fege 
Fnairn5 1 1UTaUI ER SS 记 
四 [ 


图 7.2.13 代码 生成 报告 


代码 位 于 MATLAB 当前 目录 下 的 adc_dspic_ertNsrc 文 
件 夹 , 并 且 已 经 自动 产生 了 可 执行 的 . hex,.cof 文件 ,如 图 
7. 2. 14 所 示 。 
4. 虚拟 硬件 测试 


在 Proteus 中 建立 测试 原理 图 ,选用 dsPIC33FJ12GP202 
芯片 ,其 外 围 电路 与 第 7. 1. 2 节 中 介绍 的 dsPIC33FJ12GP201 
基本 相同 ,只 是 将 晶振 频率 设置 为 8MHz。 在 AN1 端口 连接 


”全 腺 一 一- 听 


PortZrita zcrjr “CootAErige ore 00po8 ”mW/ 


和 adc 
| ame ^ 
节 sdc dspicve 了 ft 
包 下 P 全 
_ adc<cof 


上 adc.hex 
局 adcmdl 





图 7.2.14 自动 生成 HEX 和 COF 文件 
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了 一 个 电位 器 ,可 以 调整 输入 模拟 电压 的 大 小 。 在 RB0 一 RB9 连接 了 发 光 二 极 管 ,用 来 显示 A/D 转 
换 结果 ,如 图 7. 2. 15 所 示 。 








C14 C15 
2Z2pF 22pF 


图 7.2.15 Proteus 原理 图 
双击 芯片 ,打开 设置 界面 ,在 Program File 中 指定 生成 的 adc. hex 或 adc. cof 文件 ,如 图 


7. 2. 16 所 示 。 


Edit Component | 


一 -一 一 一 一 一 

Component Reference' FRR 一 加 Hidden- 
Component Value: DSPIC33FJ126P202 Hidden': 

PCB Package' [SPol2 了] [hide 庆 了 | 













Processor Clock Frequency 
Advanced Properties: 





了 
[watch window Display Format =j HEX 加 了 hde >] | 

国 
Dther Propertes: 
站 一 ES Er 忆 
中 上 
| 厂 Excude rom Smulalion Altach hierarchy module 
Exclude from PCB Layout 上 


Edi al properties as text 


一 一 一 -一 一 - -一 - 一 一 ~ -一 一 一 一 -一 一 -一 一 一 一 一 一 ~ 一 一 一 和 





图 7.2.16 加 载 可 执行 文件 
运行 测试 原理 图 。 当 调整 电位 器 时 ,AN1 端 模拟 电压 发 生变 化 , 右 侧 的 发 光 二 极 管 也 随 之 
亮 灭 变化 。 实 验 结果 显示 由 模型 自动 生成 的 代码 完全 实现 了 模型 所 表达 的 功能 ,如 图 7. 2. 17 
所 示 。 


直 
| 
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RBOQCN4RPOIAN2EMUD1POD1 
REBITCNSRP1YIANSEMAUC1 让 GC1 
RG2ICNSRP2IAN4 


RER3SMCN7RP3ANS 
RB4KN1RP4SCSCWEMYMUD3PGD3 
PRPSIASDA1 





RDB1 
RDBTSACN11RP1SIAN6 


图 7.2.17 仿真 结果 
容易 看 出 ,在 Microchip 公司 提供 的 Blocksets 帮助 下 ,配合 dsPIC _stf. tlc, 用 户 完 全 可 以 





[ 西 =TUSIEESSRTURILEEIESEEW 使 用 由 模型 自动 生成 的 代码 实现 嵌 人 支 系 统 的 开 
| 证 矶 -ETA paea Dam 发 ,而 不 需要 添加 一 行 手写 代码 ,这 将 极 大 地 提高 开 
| 基于 dsPIC 芯片 的 戏 人 式 系统 发 效率 。 
| 更 进一步 看 ,10 位 ADC 输出 的 转换 数据 其 实 就 
| 是 0 一 1023 中 某 个 值 的 二 进 制 表示 ,这 10 位 由 0\1 
组 成 的 二 进 制 编码 输出 到 B 端口 便 表 现 为 二 极 管 的 





和 
昌 | 


二 
eoe | 亮 灭 。 为 了 更 直观 地 显示 测试 结果 ,下 面 将 采用 数 
鸯 whmwt | ” 码 管 来 显示 转换 结果 。 相 应 地 ,代码 和 测试 原理 图 


需要 一 定 修改 。 
参考 第 7. 1. 2 节 内 容 在 MPLAB 中 建立 工程 ,将 
生成 的 代码 添加 到 工程 中 ,如 图 7.2.18 所 示 。 

由 于 数码 管 并 不 能 直接 将 这 些 二 进 制 编码 转换 
_decstnac | 为 对 应 的 十 进 制 数字 显示 出 来 ,因此 还 需要 一 段 数 
码 管 显示 程序 来 完成 这 项 功能 。 打 开 adc. c 文件 , 作 
如 下 修改 : 








: 图 7.2.18 MPLAB 工程 


打 include "adc.h" 

井 include "adc_private.h” 
/ xf Real-time model #/ 
RT_MODEL adcadc M_ ; 


:509 -一 区 
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RT MODEL adc x* adc M = Sadc M ; 
const uint16_T table[ ] = {0x00FC,0x0060,0x00DR,0x00F2,0x0066，// 数 码 管 可 识别 的 0 一 9 编码 
0x00B6 ,0x00BE,0x00R0 ,0x00FE ,0x00F6}; 
void delay() // 延 时 本 数 
uint16 T ii 
for(i=2000;i>0;i1- 一 ); 
} 
void disp(uint16 T ayuint16 Tb,uint16 Tc,uint16 T d) // 显 示 郴 数 
{ 
LRATB = 0x7000|table[Laj];// 数 码 管 显示 干 位 数字 
delay(); 
LRTB = 0xB000|table[ bj;// 数 码 管 显示 百 位 数字 
delay(); 
LRTB = 0xD000|table[c]j;// 数 码 管 显示 十 位 数字 
delaVy(); 
LRTB = 0xE000|table[d];// 数 码 管 显 示 个 位 数字 
delay(); 
} 
/ x#* Model step function x< / 
void adc_step(volid) 
{ 
/ *#* local block i/o variables #/ 
uint16_T rtb MDCRead,aybycydi // 声 明 中 间 变 最 


/#* SFunction (dsPIC MDCread sfun) : < Root >/RDC Read ” * / 
rtb RDCRead = ReadhDC1((uint8 T)0); //Read ADC Buffer 


a = rtb_ADCRead/1000; // 计 算 转 换 结 果 的 千 位 数值 
b = rtb ADCRead $% 1000/100; // 计 算 转换 结果 的 百 位 数值 
c = rtb_ ADCRead% 100/10; // 计 算 转换 结果 的 十 位 数值 
d= rtb_RDCReads% 10; // 计 算 转换 结果 的 个 位 数值 
/#* SFunction (dsPIC_portWrite_sfun) : < Root >/Write Port Output ” x / 
disp(aybycyd); // 调 用 显示 函数 


保存 文件 后 重新 编译 ,生成 . hex 文件 。 之 后 打开 测试 原理 图 ,添加 4 位 共 阴 极 数码 管 ,并 
将 二 极 管 删 去 ,如 图 7. 2. 19 所 示 。 

通过 第 5. 1. 2 节 介 绍 的 连 线 标签 将 数码 管 的 段 选 端口 与 RB7 一 0 连接 ,分 别 标注 为 a\b、 
…\fg.dp。 位 选 端口 与 RB15 一 12 连接 ,分 别 标注 为 1.2、.3、4。 

打开 在 MPLAB 中 建立 的 工程 ,选择 MPLAB IDE 菜单 栏 的 Debugger->Select Tool~ 
Proteus VSM, 打开 修改 过 的 原理 图 。 单 击 按钮 创 开 始 调试 , 单 击 按钮 虽 进 入 全 速 运行 状态 


各- - “331。 : 
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后 ,数码 管 上 显示 了 模 数 转换 的 十 进 制 结果 ,如 图 7. 2. 20 所 示 。 其 表示 的 实际 模拟 电压 量 为 
Vref * 788/1024, 如 果 读 者 对 用 二 进 制 数 显示 的 电压 观看 不 习惯 ,自己 可 以 进一步 用 Vref * 
788/1024 公式 把 它 变 成 易于 观察 的 用 十 进 制 显 示 的 电压 值 。 
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7.2.20 仿真 结果 
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7.2.2 闪烁 灯 


1. 闪烁 灯 驱 动 模型 


本 例 选 用 的 处 理 芯 片 dsPIC33FJ12GP202, 支 持 16 位 的 数据 类 型 ,可 直接 定义 y 的 数据 
类 型 为 unit16 ,如 图 7. 2. 21 所 示 。 


|“ Name Scope Port Resolve Signal Dataype Compile 
[[ 宫 y Output 1 


图 7.2.21 闪烁 灯 驱 动 模 型 数据 类 型 
建立 图 7. 2. 22 所 示 闪 烁 灯 驱 动 模型 ,8 个 状态 的 y 值 对 应 的 二 进 制 数 如 表 7. 2. 1 所 示 ， 
将 输出 y 与 一 组 LED 灯 相 连 , 即 可 实现 LED 灯 按 y 值 顺序 点 亮 。 
表 7.2.1 二 进 制 一 十 进 制 对 照 


1 了 IT ET 
8196 576 0000 ,0010,0100,0000 


0000,0001,1000 ,0000 





图 7.2.22 浆 烁 灯 驱 动 模型 


2. 闪烁 灯 功 能 验证 模型 


完成 闪烁 灯 驱 动 模型 之 后 ,在 Simulink 模块 库 中 找到 图 7. 2. 23、 图 7. 2. 24 所 示 的 各 模 
块 , 并 按 图 7. 2. 25 所 示 连 接 。 


了 Ports 8&Subsystems 全 
-最 | Gauges slodkeset ^ 本 Signal Attriyutes 
| 站 -Global Majic Activex Library 一 Signal Routing 
| oo 
-Demo Aircra 作 Instruments 一 | 1 六 Sources 
CE | [barpefnedrunctons 
-Linear Gauges | CuiEa | 由 -Additional Math & Discrete Data Type Conversion 
Numeric Displays | 匡 藤 Aerospace Elodkset 
上 On offGauges | 三 - 项 Communicatons Blockset 了 
图 7. 2. 23 ”Circle Meter 模块 图 7.2.24 数据 类 型 转换 模块 


村 = 基于 模型 的 设计 一 一 MCDU 篇 





Chart Circle Meter 


图 7.2.25 功能 验证 模型 
选择 模型 主 窗口 的 菜单 项 Simulation 一 Configuration Parameters… ,打开 模型 参数 对 话 
框 ,在 Solver 界面 中 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0. 01, 如 图 7. 2. 26 所 示 。 


Solver options 





Type: Fixed-step | Solver: | discrete (no continuous states) ~ | 


Fixed-step Size (fundamental sample time): 0.01 


图 7.2.26 求解 器 设置 
设置 Circle Meter 模块 LED 灯 数 量 为 16 ,输入 数据 模式 为 1-Bitwise, 如 图 7. 2. 27 所 示 。 


和 seeee verneeaaoeeneeemeemcemneeen 


NumLEDs: |16 于 填 _ 
LEDindex- 车 Value: 18196 
LEDSiylelD j 了 
广 Dimensions 
LEDWidih: P 
厂 MouseControl LEDHeight 9 


Mode. [Biwsge 评 ” -~ LEDSeparaion- 民 


Direction': [o- Foward | Decay LED 
Orentation: po -Horizontal | MaxDecay- 六 
AutoSize po - None | DecayRate: Po 





图 7.2. 27 Circle Meter 模块 设置 
完成 以 上 设置 后 执行 仿真 , 即 得 到 设计 所 需 的 亮 灯 图 样 ,如 图 7. 2. 28 .图 7. 2. 29 所 示 。 





Chart Circle Mieter 


图 7.2.28 功能 仿真 结果 





Chart Circie Meter 


图 7.2.29 功能 仿真 结果 
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3. 软件 在 环 测试 (SIL ) 
软件 在 环 测试 (SIL) 是 在 主机 上 对 仿真 中 生成 的 函数 或 手写 代码 进行 非 实时 性 联合 仿真 
评估 , 当 软 件 组 件 包 含 需要 在 目标 平台 上 执行 的 生成 代码 和 手写 代码 的 组 合 时 ,应 该 考 起 进行 
软件 在 环 测 试 ,完成 对 模型 生成 代码 的 早期 验证 。 
软件 在 环 测试 不 需要 硬件 ,只 是 对 算法 代码 进行 测试 ,具体 做 法 是 对 要 进行 测试 的 子 系统 
编译 可 生成 SIL 模块 ,比较 原 模块 与 SIL 模块 的 输出 ,以 此 确认 算法 的 正确 性 。 


(1) 数据 类 型 转换 。 在 模块 库 Smulink 


Name Blockfype OutDatafypesStr N 


一 Ports 以 Subsystems 中 找到 模块 ,替换 图 著 Model Workspace 
7. 2. 25 中 的 Circle Meter 模块 ,并 将 模型 入 codefor blink_sim 


凶 Adyice for blink_sim 


另 存 ao 名 》Configuration Activej 
单 击 模型 窗口 的 按钮 有 ,打开 模型 浏览 它 C。 
器 9 闪烁 灯 张 动 模型 里 恋 量 的 数据 类 型 已 设 癌 Data ype Conversion jinherit': Inherit via ,.， 


置 为 uint16 ,Simulink 模型 中 的 Out 模块 的 于 


数据 类 型 可 设 为 自动 继承 ,也 可 强制 设置 为 


图 7.2.30 修改 端口 数据 类 型 


uint16 ,如 图 7. 2. 30 所 示 。 
修改 后 的 模型 如 图 7. 2. 31 所 示 。 
(2) 模型 参数 设置 。 打 开 模 型 参数 对 话 框 , 在 Real-Time Workshop 界面 设置 TLC 文件 


为 ert. tlc, 如 图 


7. 2. 32 所 示 。 


Target selection 





System target file: ert.tic | Browse,.. 
uint16 ER AR 
区 职 Language: |C ~| 
Description: Real-Time Workshop Embedded Coder 


Chart 


图 7.2.31 


代码 生成 模型 图 7.2.32 设置 TLC 


在 Real-Time Workshop~>Interface 界面 ,取消 勾 选 不 必要 的 复 选 框 , 如 图 7. 2. 33 所 示 。 


Software environment 


Target function library: 





Utility function generation: | Auto | 
Support: 王 ] floating-point numbers tom- 人 nite ngrmnbef: [| complex numbers 
absolute time continuous time [nonrr-inlined S-functions 


| variable-size signals 


Multiword type definitions: | System ded oroweneacenea | 


图 7.2.33 interface 页 面 设 置 


在 Real- Time Workshop~~Report 界面 , 勾 选 所 有 复 选 框 ,便于 后 期 检查 及 跟踪 ,如 图 7. 2. 34 所 示 。 
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vv Create code generagon report vy Launch report automaticaily 
Navigation 


疝 Code-to-fmodel 

yj Model-to-code [conigure 
Traceability Report Contents 

y Eliminated / virtual blocks 

V Traceabie Simulink blocks 

vI| Traceable Stateflow objects 

7 Traceabie Embedded MATLAB functlons 


图 7.2.34 报告 界面 设置 


(3) 生成 SIL 模块 。 在 ReaLTime Workshop 一 SIL and PIL Verification 界面 的 Create 
block 下 拉 列 表 ,选择 SIL 选项 ,如 图 7. 2. 35 所 示 。 


Software-in-the-loop {SIL) and processor-in-the-loop〔(PIL) ver 布 cation 
Enable portable word sizes 


SIL Or PIL Verification block 


Create block: [SR | 





图 7.2.35 SILL 设置 


之 后 单 击 模型 工具 栏 的 按钮 尚 ,, 得 到 代码 生成 报告 如 图 7. 2. 36 所 示 ,SIL 模块 如 图 7. 2. 37 
所 示 。 


ER | Fererd 
2 二 idefirned(S FUNCTION_RANE) 
ba 7 define S FUNCTION _NANMR blink_sim_sf 1 
二 不 Sn) 丰 
summary 
Subsystem Report zadefinras S FUNCTIONK LEVEL 2 生 


Code Interface Report 


ez DIEanTe SI alDirahlie II he dotrzned JIp 请 315SEFUC 页 古 / 


Traceabllity Report 2 Mif dafinedRTW 5ENEKATED_S_FUNCTION) 
taefines RTV_CENERATED_S_FUNCTIOK 

Generated Files 于 

[再 ain fle 


着 Clude 《stdi6.h》 
at_malinx5 副 和 Neciudes 《ah hh; 
nclude “sinstruc kh 





[] Model 作 es 辣 Winciuds “fixeapoirt 
blnk_ sim.5c #detfine rt_logging_h 
#daGecfie KRIWSfenInfo Vold * 
bbhok_ stm 由 厅 ”机 pclude“blinig_ SI RN” 
blink_sSim_prnvateh ( 
bink_sim_ typesnhn 4 Static it8 T blzirE_sin_ sf_courter = 0; 
[-] Utility fies 53 中 
rtwtypesh 表 z 了 5 Totior rezTsfer to npPOof End oufpt SITz7ia7 FOODETEEeS 厅 
了 5 Am Benmerate ER Code， 
[-] Interface files 了 7/ 
bjink sim 车 e 57 static void mdlIrnitializeSizestSinStruct +S) 
{ 


(Ta 六 Parnmetf -6 声 / 
- 


图 7.2.36 代码 生成 报告 


RTW S-Function 
图 7.2.37 SIL 模块 
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如 图 7. 2. 25 所 示 , 以 SIL 模块 替换 原 有 的 闪烁 灯 驱 动 模型 ,重建 验证 模型 ,该 模型 的 运行 结 
果 与 功能 验证 模型 是 一 致 的 ,说 明 自 动 生成 的 代码 能 实现 驱动 模型 的 功能 ,如 图 7. 2. 38 所 示 。 





RTW S-Function Circle Meter 
7.2.38 软件 测试 结果 


4. 代码 生成 模型 及 设置 


在 Simulink-> Target for Microchip dsPIC 子 模块 库 找到 以 下 模块 ,如 图 7. 2. 39 一 
7. 2. 42 所 示 ,并 按 图 7. 2. 43 所 示 连 接 。 


于 匡 farget er Marochptrw) dspIc 5. 勋 Targetfor Moodhp(rM) dspIc 


一 dspIC CMathtib | jdspICCMathUhb 
一- dsPIC DSPib 人 人 性 1 ij- dspICcDSPib | | Somecuztcomgue 
| dspIC QMathub | |- aspICQMathub 人 


| | dsPIC Run Time Library 
fdsPIC33fDMC Aigos | Wi PotOutput ws dsPIC33f DMC Algos 





| “dsPIC Configuration | | 5 
+ 了 vehsde Network Toolbox | + 最 Wehide Nebwork Tooclbox 
图 7.2.39 Write Port Out put 模块 图 7.2.40 “Config 模块 
十 般 Target for Miaochip(TM) dsPIC ts 二 - 贡 Target for Microcdhip(TM) dsPIC 
| 二 dspIC CMathtib i dspIC CMathLib 
|- dsPIC DSPib AN | | dspICDpsplb 
一 dsPIC QMathLib oopIF Any Com1g | dspICQMathub 
;二 dspICRunTmelLibrary | 1 |- dspICRunTimeLibrary 
| 三 dsPIC33fDMC Agos | Pod Conng | 把 dsPIC33f DMC Aigos ne 
LEETRRTTTIREES ET 


+ -最 vehde Network Toolbox 史 - 最 vehide Network Toobox 


到 训 | 


图 7.2.41 Port Config 模块 图 7.2.42 dsPIC33fxx Main 模块 


cp Pory Contz2g 





Chart Write PortOutput 


Port Corfig 


图 7.2.43 闪烁 灯 模型 
(1) 双击 dsPIC33fxx Main 模块 ,选择 振荡 源 为 Low power RC oscillator,Fey 显示 默认 
值 16384, 如 图 7. 2. 44 所 示 。 
(2) 双击 Write Port Outpnut 模块 ,选择 输出 口 为 B, 取 消 勾 选 Write to selected Pin/s 复 
选 框 ,如 图 7. 2. 45 所 示 。 


二 wm ， 


县 基于 模型 的 设计 一 一 MCU 篇 


”Osclllator Configuration | Watchdog Configuration | code 
Choose the dsPIC33 j33F]J12GP202 ae 





Timer | 下 imneril 


Oscillator Source Selection Low power RC oscillator 


Fcy ( jnstructions/Sec = Foscf2 ) 人 


Required Main Loop Time (ms) 


1 


图 7.2.44 dsPIC33fxx Main 模块 设置 


(3) 双击 Port Config 模块 ,选择 端口 了 的 方向 为 Output, 取 消 勾 选 Configure selected 
Pin/s 复 选 框 , 如 图 7. 2. 46 所 示 。 








ParameterS 
Configure as |output FT es -| 
Parameters 有 es 5 2 ES 
SR 2 Select Port |B | 
Select Port |B wei 
本 ae Configure selected Pin/s 
Wirite to selected Pinm/s 
Select the Pin/s for eg: [6] to select pin 6 
Select the Pin/s for eg; [3:5] to select pins3.4 and 5 [0:15] 
[0:15] 
7.2.45 Write Port Output 模块 设置 7.2. 46 ”Port Config 模块 设置 


(4) 双击 Config 模块 ,系统 自动 设置 TLC 文件 为 dsPIC _stf. tlc, 并 在 模型 参数 对 话 框 中 
添加 一 个 dsPIC Options 界面 。 在 生成 代码 前 ,用 户 应 事先 检查 该 界面 所 有 条 目 对 应 的 文件 
是 否 存在 ,如 图 7. 2.47 所 示 。 


Optimization Parameters( OGCC ) -03 -9 -fschedule-insns -fschedule-insns2 

Unker Options( LDFS 】 - 飞 --reportmem -Map ..Juntitied.map 一 heap0 -cref 

Microchip Compiler Path( MCPATH 】 C:VPROGRA~IWMICROC~IWMPLABC~2 

Linker Script (LINKERSCRIPT) 《CAProgram Files\WMicrochip\VMPLAB C30VSupport\dsPIC33F\gldp33F]J12GP202.9ld 
Enter LUibraries ( PICLIB ) ICROC~1VWMPLABC~2ViibWibq-co 剑 a C:\PROGRA~IMVMICROC~IVWMPLABC~2Mib\Wibq-dsp-coffa 


Header Include Path( PICINCL ) C~1VWMPLABC~2Vnciude -ICAPROGRA~IAMMICROC~IWMPLABC~2WsupportvdsPIC33FWh 


图 7.2. 47 “Config 模块 设置 


(5) 在 Hardware Implementation 界面 中 ,选择 硬件 设备 为 Microchip 公司 的 dsPIC, 如 图 


7. 2. 48 所 示 。 
Embedded hardware (Simulation and code generation) 


Device vendor: | Microchip ~ | Device type: |dsPIC | 


图 7.2.48 选择 芯片 





第 7 章 基于 Simulink 模块 的 dsPIC 单片机 开发 - 旱 


(6) 将 Real-Time Workshop 一 SIL and PIL Verification 界面 的 Create block 下 拉 列 表 ， 


选择 none 选项 ,如 图 7. 2. 49 所 示 。 


Software-in-the-loop (SIL) and processor-in-the-loop(PIL) verification 
户 ) Enable portable word sizes 
SIL or PIL verification block 


Create biock: LNone pe 
图 7.2.49 SILVPIL 设置 二 
《7) 单 击 模型 工具 栏 的 按钮 出 ,生成 代码 ,报告 如 图 7. 2. 50 所 示 。 
back Forward j 字 


7 了  ##irclude “blink.h 
#include “blink_ private。ih” 





Summary J5  _FWDTIFWDTE 贡 DFF) 
Sweet 77  ，， _FOSC(FCKSNLCSDCID&OSCIOFRC_ON&POSCIND_HS) : 遇 
cod R 人 3  _FOSCSEL (FNOSC LPRC&IESO_DFF) : 
Se nn SP& y2  _FGS(GSS_OFFASCP_OFF&GWRP_OFF) : 
ITrac hty R 22  _FICDKICS_PGD1) : 
-一 -一 -一 一 -一 一 一 - 2 Volid rt_DneStspr) 
Generated Files 2 
?33 了 1w 站 IT55PTP IFErYUPES 态 ePe mm] 
[-] Model files 2 
blnk.c 35 As 5566 天 PE coptext 方 eye 在 Dece55air 贞 / 
Enmk 四 2 7 洲 而 局 一 记 站 二 7P 了 前 BT Di ImferFapt 让 eire 网 / 
bunkeea 327 blink stepf); 
link_pnvate,h 中 
blink types.h 29 1 Get 肌 DDeI Dofpbf5 矶 pie LUi]/ 
[-] Utility fles jg 了 55phTe 了 IDyrerripE5 态 ePe 7 
rtwtypes,h 3 Au 并 e5fDie 闪 PE Context 方 ere 全 PEe5sEPzr WA/ 
了 Au 瑟 F5m7e nterrupts 方 EFe W7 
[-] Interface files 好 
ild ,hb 弛 
短 int16 T mainfyzoid) 
[-] Dther 和 es 3 
Interrupts.c 陀 PLLFBD = 0: 到 三 了 
-了 9 CLKDIVWbits,P?LLPOST = 0: /有 岗 三 3 
吕 an f0  CLKDIVbits.PLLPRE = 0: Ar 一 = 3 
Eree access 弛 7 __RCONbits 有 ITEE 站 zw .075 让 ?7e 多 
图 7.2.50 代码 生成 报告 
s$. 虚拟 硬件 测试 


不 同 于 第 5 章 ,dsPIC 的 自动 代码 生成 过 程 并 不 打开 IDE 编译 环境 ,而 是 直接 生成 HEX 


文件 ,生成 的 源 代码 保存 在 模型 当前 目录 的 modelname_dspic_ert 子 目 录 下 。 


当 MATLAB 命令 行 显 示 大 致 如 图 7. 2. 51 所 示 时 , 即 生 成 了 modelname. hex 与 model- 


name. cof 文件 。 


辆 : 基于 模型 的 设计 一 一 MCU 篇 


Pile Edt Debug Desktop Window “Help 下 


Data Memnory [Origin = 0x800，Length = 0Dxd400] 
| 


Sect1Ion addresss 311gruient gapS tot3al lerngth 【dec) 
nbss 0Ox800 0 0x8 (8) 
ndat 也 Dx808 0 0x2 【2) 
TIota3al data enory UsSed (bytes) : 0xa (10) 《1% 
DynamdIc Memory USsage 
Yegiom address 3aXIUm lergth (dec) 
heap 日 6 10) 
St3ck 0Qx80a fx3f6 (1014) 
axlnmum dynsmic 卫 emory (bytes): 0x3ft6 (10134) 
“水 六 前 记 TeSted ”executable : .vblink.cof” 
pic30-bin2hex -onmf=coftt .. .AblLink.cof | 


### Successful completiorn of Microchip Embedded Iargest bulild procedure for modelI: blirnk 


将 >》 
1 


搭建 proteus 模型 ,加载 生 成 的 HEX 文件 , 单 击 “ 人 仿真" 按钮 ,得 到 与 功能 验证 模型 一 致 的 


图 7.2.sS1 编译 信息 


亮 灯 图 样 , 如 图 7.2.52.、 图 7.2.53 所 示 。 


RT 10kQ& 
[ 王 






RB1CNS/RP1AN3SEMUC1/PGC1 

VDDCORE RB2ACN6RRP21AN4 

C1 RB3MACNTRP3IAN5 
RB4)CNTRP4SOSCIEMUD3IPGD3 

RB5MCN27JRP5IASDA1 

ae aYDD RB6JICN24 有 RP6/ASCL1 
108F &VYSS RB7MCN23IRP7MNTO 
RBSCN22 有 RPBSDA1ITCK 

RBSICN21 丰 PSCL1TCK 

pre RB1OCN16RP10TDI 
-~ RADNCN2YREF+ 屋 NOEMUD2yPGD2 RB11CN15SRP11TMS 
RA1CN3SWREF-IANIEMUC27PGC2 RB12/CN14 和 RP121AN9 

RA2MCN3OICLKUOSCI RB13CN13RP13/AN8 

RA3NCN29ICLKOMOSCO RB14iCNI2RP14IAN7 
RA4iCNOT1CKSOSCOEMUC3iPGC3 RB1SICNI1TRP15IAN6 





DSRPIC33FJ12cCP202 


RBOICN4RPOAN2EMUD1APGD1 





图 7.2.52 仿真 结果 
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RBOKCN4FRPOAN2EMUD17PGCD1 
RPRB1KCNSRP1IANSEMUCT1TPGC1 
DORE RB2KNBRP2IAAN4 

REGSACNTRP3SIAN5 
RB4KN1RP4SOSCIEMUD3iPGD3 








C1 








100nF 10pF 


一 RADACNZYYREF+IANDEMUD2PGD2 
RA1ACN3VYREF- 人 AN1EMUC2fPGC2 





LED-BARGRAPH-RED 


图 7.2.53 仿真 结果 


用 户 也 可 以 用 逻辑 分 析 仪 替换 LED 灯 , 如 图 7.2.54 所 示 , 详 细 分 析 亮 灯 的 时 序 ， 
如 图 7. 2. 55 所 示 。 





R1 ”10kQ 
FE 站 
R2 1k 4 “an 
区 MECLR RBOCN4 疏 POIAN2EMUD1fPGD1 六 5 一 6 一 
0 RB1IAKNSRP1AANSEMUCTIPGC1 6 | 
REZKCNBRF2AN4 和 7 6 | 
RB3ACN7 和 RP3IAN5 
[11 ad4 
C1 C | + RB4/CN1 丰 P4SOSCIEMUD3iPGD3 《六 1 一 号 一 
100nF 10pF 27 rs 
RBB/CN22 丰 PSBSDA1TCK ”六 16 一 5 一 | 
RB9CN21RP9SCL1ATCK 人 | 
一 a RB1OKCN16RP10rD 广 这 一 5 一 
“ 人 | RADAKCN27VREF+4ANOEMUD2/PGD2 RB1HMCN15RP11TMS ”六 绿 一 1 一 
下] RATCN3WYREF-IAN1EMUC27PGC2 RB12MCN14RP12IAN9 六 为 一 5 | 
| RA2MCN3OMCLKUMOSCI RB13ACN13RP13IAN6 半 25 一 4 一 
RA3SNCN29KCLKO/OSCO RB14XCN12RP14IAN7 一 倪 一 515 一 
RA4ICNOT1CKISOSCOEMUC3PPGC3 RB15XN11TARP15/ANG6 一 
DSPIK33FJ12GP202 
an0 
RE 
[2 
| | 
7 
| 
La6 





图 7.2.54 逻辑 分 析 仪 茜 换 LED 灯 


0 
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图 7.2.55 运 辑 分 析 仪 波形 
7.2.3 调用 现 有 C 函数 


1. 创建 功能 验证 模型 


在 Simulink 模块 库 中 找到 图 7. 2. 56 .图 7. 2. 57 所 示 模 块 ,并 按 图 7. 2. 58 所 示 连 接 ,建立 
一 个 简单 的 加 法 模型 ,对 于 实际 应 用 ,加 法 模块 可 以 替换 成 各 种 具体 的 算法 。 








一 遇 Smulink <^ 
[一 Commonly Used blocks 本 可 Gauges Biockset “| 
ji-Contmuous | | 轧 -Global Majic 上 ActiveX Library 
iDiscontinuities 处 十 十 | |- Anguiar Gauges [于 | 
-Discrete | JR iDemo Aircraft instruments || 
iLogic and Bit Operations i-LEDs || 
L. Soum ， 。 
rLOokup Tables 一 Linear Gauges smetoykggirg2r -了 
NM 记 协 Operations 
TI 0 
图 7.2.56 Sum 模块 图 7. 2.57 Ceneric Numeric LED 模块 





Generic Numeric LED 


图 7.2.58 功能 验证 模型 


- 心 务 
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1 位 十 进 制 整数 加 法 的 和 最 多 为 2 位 十 进 制 整数 ,因此 设置 数码 管 的 显示 位 数 为 2 位 整 
数 .0 位 小 数 , 如 图 7. 2.59 所 示 。 





DecimalSize: | 一 | OffColor 
aicsOffset | OncColor 


5egment fpiels} 一 一 
和 
「 ”LeadingZeros | LeadingOnePigi 
三 LeadingPlusMinus ”大 FxedDecimal Width ”Separation 
DisplayMode -Numerc | Spacing (ppxels)j 一 一 一 
= 5 
交 |11234.56 
Nt Horizontal 。 Vertical 


图 7.2. 5S9 Generic Numeric LED 设置 


选择 模型 主 窗口 的 菜单 项 Simulation 一 Configuration Parameters… ,打开 模型 参数 对 话 
框 ,在 Solver Options 界面 中 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 7. 2. 60 
所 示 。 


Solver options 


Type: | Fxed-step 。 ~ | Solver: | discrete (no continuous states) ~| 





Fixed-step size (fundamental sample time): 0.01 


图 7.2.60 求解 器 设置 
仿真 结果 如 图 7. 2.61 .图 7.2.62 所 示 。 








Generic Numeric LED Genenc Numeric LED 


图 7.2.61 功能 仿真 结果 { 一 ) 图 7.2.62 功能 仿真 结果 (二 ) 


2. 软件 在 环 测试 


(1) 数据 类 型 转换 。 在 模块 库 Simulink->Ports & Subsystems 中 找到 输入 模块 与 输出 模 
块 , 替 换 图 7. 2. 58 中 的 常数 与 LED 模块 ,并 将 模型 另存 。 

单 击 模型 窗口 的 按钮 肥 ,打开 模型 浏览 器 ,将 功能 验证 模型 中 的 In 模块 的 数据 类 型 设置 
为 uint16 ,加 法 模块 的 数据 类 型 设置 为 uint16 ,Onut 模块 的 数据 类 型 可 设 为 自动 继承 ,也 可 强 
制 设置 为 uint16, 如 图 7. 2. 63 所 示 。 

修改 后 的 模型 如 图 7. 2. 64 所 示 。 


首 一 一 一 下 本 光 .343，。 1 


基于 模型 的 设计 一 一 MCU 篇 





Name BlockfWpe DutDataTypestr DataTp| 
多 Advice for ccail_ 5 
| 她 Code for ccall_5i 
和 Confiduration ctivej 


F 
| 
| 
| 





也 Ini | 
瑟 ma 
蕉 Model Workspace | 
马 outi JUPort | Inherit auto 
互 Sum Ui Uintl6 


图 7.2.63 修改 模型 端口 数据 类 型 


Target sejlection 





System target 人 e: ert.tlc _Browse,.， 

Language: [c 

Description: ReaHTime Workshop Embedded Coder 
图 7.2.64 代码 生成 模型 图 7.2.64 TLC 设置 


(2) 模型 参数 设置 。 打 开 模 型 参数 对 话 框 , 在 ReaL-Time Workshop 界面 设置 TLC 文件 
为 ert,tlc, 如 图 7. 2.65 所 示 。 
Real-Time Workshop->~JInterface 界面 ,取消 色 选 不 必要 的 复 选 框 , 如 图 7. 2. 65 所 示 。 


Software environment 





pp asscaeec 和 eaesoas ， 
Utility function generation: |) Auto | 
Support: 二 foating-point numbers fom-Finite mdurmtbers 癌 complex numbers 
局] absolute time 上 continuous time 问 ] non-inlined S-functions 


证 | variable-size signals 


Multiword type definitions: System de ia 


7. 2.65  Jnterface 界面 设置 
Real- Time Workshop 一 Report 界面 , 勾 选 所 有 复 选 框 ,便于 后 期 检查 及 跟踪 ,如 图 7. 2. 66 所 示 。 


局 Create code generation report 名 Launch report automatically 
Navigation 


尼 Code-to-model 


加 ModeHto-code 【configure,.] 


Traceability Report Contents 

局 Ehminated /virtual blocks 

区 Traceable Simulink blocks 

尽 ] Traceable Stateflow objects 

局 Traceable Embedded MATLAB 名 nctions 


图 7.2.66 报告 界面 设置 
”一 
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(3) 生成 SIL 模块 。 在 Real-Time Workshop-=~>SIL and PIL Verification 界面 的 Create 
block 下 拉 列 表 ,选择 SIL 选项 ,如 图 7. 2. 67 所 示 。 


Software-in-the-loop (SIL) and processor-in-the-loop (PIL) verification 


同 Enable portable word sizes 
SHL or PlL ver 币 cation block 






Create block: | SEE 


图 7.2.67 SIL 设置 


之 后 单 击 模型 工具 栏 的 岗 按钮 ,得 到 代码 生成 报告 如 图 7. 2. 68 所 示 ,SIL 模块 如 图 7. 2. 69 
所 示 。 


< 
* Chipedgde0 六 5rapare 5eliecrIo0H DBD-DTt CemerIr 
* DOde Eemeratzoprr DJecrtfiyesy speczfrIec 

k 5705fIom re5tt7 pf Ten 
天 
严 


BackK | Forward | 


Contents 1 国 
Summary 曲 
2uUbsSystem Report 322 4#if idefined(S_FUNCTION_NAIE) 
code Interface Report >27  #define S_FURNCTION_NATE ccall_sil_sf 
Traceabihlity Repot 2 endit 

#detine 3_ 了 FUNCTION _ LEVEL 2 


Generated Files 
[-] Main 他 le (1 5SD 贡 GTIFEnapble and mdlpisapbp7ye pwITJI7 pe defned 了 巧 让 e 
。 #if idcfinecd(RTW CENERATED 3_FUNCTION) 


ert_main.C 
ee #define RTV _CEINERATED_S_FUNCTIOHN 
[-] Model fles 7 六 emdit 
让 引 . 
7 了 林 IzWClude “stdao,j> 
all_silh 到 #include <math,h》 
ccall_sil _private.h 厅 #include ”simstruac.h 
| si h 字 #include“fixecdpoint.h” 
= 也 和 #defire rt_loggling_h 
[-] Utility 有 les 超 #aefines 有 TVSfcnInfo VOId 水 
六 关 ”2 SI1.h” 
veeae 抽 include “ccall_s11 
[-] Interface files zy/ statlc lintg T ccall_slil_sf_counter = 0; 





ccCall Sil sf 
总 让 天 中 


rr Th7r- fazmrtioy rewzsters the Inpit 5 Dofnaf -27 了 


图 7.2.68 代码 生成 报告 


如 图 7. 2.70 .图 7.2.71 所 示 , 以 SIL 模块 蔡 换 原 有 的 Prod- 
uct 模块 ,重建 验证 模型 ,并 在 各 端口 间 加 入 必要 的 数据 类 型 转换 
模块 。SIL 测试 的 结果 ,如 图 7. 2.70 .图 7. 2.71 所 示 结 果 与 图 
7. 2.61、 图 7. 2. 62 所 示 的 结果 是 一 致 的 。 说 明 自动 生成 的 代码 可 本 
图 7.2.69 SIL 模块 
以 实现 模型 的 功能 。 
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RTW S-Function Generic Numeric LED 


图 7.2.70 软件 在 环 测试 结果 


doubke | Comer PE 


| Comver | 


| Comert | 





RTW S-Function Generic Numeric LED 
图 7.2.71 软件 在 环 测 试 结果 


3. 代码 生成 模型 及 设置 


在 Simulink->Target for Microchip dsPIC 子 模块 库 找 到 图 7. 2. 72 一 图 7. 2. 77 所 示 的 模 
块 , 并 按 图 7. 2. 78 所 示 连 接 。 








= 于 Tar9et for Microchip(TWM) dsPIC 二 蝇 Target foc Microchip(TM) dsPIC 
ij dsPIC CMathUib dsPIC CMathtib 
| dsPIC DSplib 售 - | 上 dspIcDsplb uintte 从 
dsPIC ER | 六 dspPIC QMathtb 
SECTT Wi _ ssPIC Rn Tine brary 
一 dsPIC33fDMC 人 | ~ dsPIC33f DMC Aigos 有 
中 PIC Confguration 一 dPIC Confouration 
+ 其 hide Nebwork Toolbox 号 +- 驶 hde Nebwvork Toolbox 蝇 
图 7. 2.72 Read Port Inpaut 模块 图 7.2.73 “Write Port Output 模块 
一 最 Target for Microchip(TM) dsPIC 一 - 到 Target for Microchp(TM) dsPIC 
-~ dspIC CMathUib 1 dsPIC CMathtib 
idsPIC DSPb cueui | 广 dspIC Dsp 人 b 下 
-dspIC QMathub 上- dspIC QMathtb 浊 
depiC RimTmetibrary dcpICcRounTmeLibrary 
一 dsPIC33f DMC Aligos - | 上 - dspIC33f DMC Aigos 总 
| 一 dsPIC Confgouration PIC Ceonfiguraton 
+ 可 vehide Nebwork Toohbox we +- 吕 : Wehide Network Toolbox 
7.2.74 “Call 模块 图 7.2.75 “Config 模块 
二 芍 Targetfor MicochpfTM) dsPFIC | 一 员 Target for MoodhptrM) asPIC 
| dspICCMathtb | |- dspICCMathib 上 
一 dsPIC DSpPihb | “上 dspIC DSP 人 b | 
F- dsPIC QMathtib 一 dsPIC QMathtib 
| … dsPIC Run Time Library | dspICRunTmeLibrary | 
idspIC33fDMC Algos Po | 六 dsPIC3 于 DMC gos 二 4sPIC33bot Niain 
SPIC _ Configourabon 2 dpPIiC Confgbration 于 | 
+ 生 Wehide Network Toolbox +#- 蝇 vehide Network Toolbox 二 拉 
图 7.2.76 Port Config 模块 图 7.2.77 dsPIC33fxx Main 模块 


单片机 的 输出 端口 通常 是 不 能 直接 显示 2 位 以 上 十 进 制 数 的 ,为 此 需要 将 十 进 制 数 的 每 
一 位 分 离 出 来 ,单独 送 数码 管 显 示 。 
以 下 C 代码 实现 了 2 位 十 进 制 数 的 分 离 ,以 函数 名 作为 文件 名 保存 , 供 cCall 模块 调用 。 


， .346 
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int dec(unsigned int x) 

{ 
unsigned int Sumij 
unsigned int al,a2; 
al =Xg 10; // 计 算 个 位 
a2 = x/10; // 计 算 十 位 
sum = a2<<4|al; 


return Sum; 





dsPlIC33fc Main Config 


从 


cgpTr Pory Config 


Resd Fort Config CC 


cp Pory Con1g 


Read Port Config 入 


从 


apTV Pory Con/8 


风 rite Port Output B 





Write Port Config 日 


图 7.2.78 Simulink 功能 验证 模型 


模块 与 模型 参数 设置 与 7. 3. 1 节 无 太 大 差异 ,这 里 仅 作 简 单 罗列。 

(1) dsPIC33fxx Main 模块 ,选择 处 理 器 芯片 为 33FJ16GP304 ,振荡 源 为 Low power RC 
oscillator,Fcy 显示 默认 值 16384, 如 图 7. 2. 79 所 示 。 

(2) 双击 cCall 模块 ,指定 需要 调用 的 C 函数 ,函数 名 应 使 用 半角 单 引 号 包围 ,如 图 7. 2. 80 所 示 。 


Parameters 


Number of Outputs | | 

Choose the dsPIC33 [33Pl6GP304 = FRR 
~ 一 一 一 一 一 一 一 一 一 一 Number of inputs ;3 ~; 

Timer |Timer1l 、 
IJnputl Type Laintl6 “9 
Osclllator Source Selection Low power RC oscillator 


Fcy ( jnstructions/Sec = Fosc/2 } 、 


= ~ = 一 = 
Required Main Loop Time (ms) Outpat ype Li 


Input2 Type [uintl5 ~| 


imput3 TYpe [untl6 .| 


7.2.79 dsPIC33fxx Main 模块 设置 图 7. 2. 80 ceCall 模块 设置 
儿 “347。 ; 
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(3) Read Port Input。2 个 Read Port Input 模块 的 输入 引 脚 分 别 为 端口 C、 端 口 A, 不 应 
勾 选 Read from selected Piny/s 复 选 框 , 如 图 7. 2.81 所 示 。 


Parameters 


Select Port fc en =] 


户 ; Rez Parameters 


Select Select Port 
[0] 。 辣 Read from selected Pinys 


Select the Pin/s for eg: [6] to select pin 6 
[7] 


图 7.2.81 Read Port Input 模块 设置 


《4) 人 ead Port Config。 选 择 端口 C 的 方向 为 输入 , 勾 选 Configure selected Pin/s 复 选 
框 , 引 脚 定 义 为 L0:3], 如 图 7. 2. 82 所 示 。 


选择 端口 A 的 方向 为 输入 , 色 选 Configure selected Pin/s 复 选 框 , 引 脚 定 义 为 [7:10], 如 
图 7. 2.83 所 示 。 








Parameters Pararmeters 
Configure as |mput is ea Configure as | Input ~] 
selee Part 医 。w eaeaasaaa ee] Select Port [人 peiRguaggaRotsssacs] 


j 


风 Configure selected Pin/s Y Configure sejected Pin/s 
Select the Pim/5 for eg; [6] to select pin 6 


Select the Pin/s for eg: [6] to select pin6 
[0;3] 


[7:10] 


图 7.2. 82 Read Port Config 模块 设置 图 7.2. 83 Read Port Inpnt 模块 设置 


《5) Write Port Output。 选 择 输出 引 脚 为 端口 B, 取 消 勾 选 Write to selected Pin/s 复 选 
框 , 如 图 7. 2. 84 所 示 。 


《6) Write Port Config。 选 择 端口 B 的 方向 为 输出 ,取消 勾 选 Configure selected Pin/s 复 
选 框 , 如 图 7. 2. 85 所 示 。 








Paframeters 
Parameters Configure as 
Select Port @ =] Select Por 四 二 2 到 
问 Write to selected Pins ae AS 
Select the Pin/s for eg9: [3:5] to select pins 3,4 and 5 Select the Pin/s for eg: [6] to seled pin 6 
[0: 如 [0:7] 


图 7.2.84 Write Port Output 模块 设置 图 7.2.85 Write Port Config 模块 设置 


《7) 双击 Config 模块 ,系统 自动 设置 TLC 文件 为 dsPIC_stf. tlc, 并 在 模型 参数 对 话 框 中 


添加 一 个 dsPIC Options 界面 。 在 生成 代码 前 ,用 户 应 事先 检查 该 界面 所 有 条 目 对 应 的 文件 
是 否 存 在 ,如 图 7. 2. 86 所 示 。 
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Optirmmizstion Parameterslt 0GCC ) -03 -9 -fschedule-insns -fschedule-insns2 

Linker Dptionst LDFS 】 -~-reportmem -Map .Juntlied.map -heap 0 -Cref 

Microchip Compaer Path( MCPATH ) C:MPROGRA~IWMICROC~1MWMFLASC~2 

Unker Script (LINKERSCRIPT) C:VProgram FilesVMacrochipVMPLAB C30VsupportydsPFIC33F\gld\p33P)I2CP202.9ld 
Enter Libraries ( PICLIB ) ICROC~IVWMPLABC-2\ibWibq-coffa C:VPRDGRA~IVMICRDC~1VMFPFLABC~2VhbWibq-dsp-co 人 fa 


Header include Pathf PICINCL ) C~IVMPLASC~2Vincude - 汇 :VPRDGRA~1VWMICROC~1WMFLABC~2sSupportVdsPIC33F 由 


图 7.2.86 dsPIC Options 界面 设置 


(8) 在 Hardware Implementation 界面 ,选择 硬件 设备 为 Microchip 公司 的 dsPIC, 如 
7. 2. 87 所 示 。 
Embedded hardware (simulation and code generation) 


Device vendor : Microchip | Device type: | dsPIC | 


图 7.2.87 选择 芯片 
(9) 将 Real-Time Workshop-~>SIL and PIL Verification 界面 的 Create block 下 拉 列 表 ， 
选择 none 选项 ,如 图 7. 2. 88 所 示 。 
Software-in-the-loop (SIL) and processor-in-the-loop (PL) verification 


局 Enable portable word sizes 
SL or PIH verification block 





Create block: | None gj 





图 7.2.88 Interface 界面 设置 


4. MPLAB 环境 下 的 代码 生成 及 修改 


这 时 用 户 可 以 单 击 模型 工具 栏 的 沿 按 钮 ,生成 代码 。 不 过 本 节 使 用 另 一 种 方法 实现 这 一 过 
程 。 用 户 若 完全 安装 了 MPLAB IDE v8. 56 ,软件 菜单 项 Tols 下 应 有 Matlab/Simulink 命令 ,如 
7. 2. 89 所 示 。 


Rile ”Edit View ”praject Debugger programmer 上 ooE| Confgure Window Help 
D 依 渤 ; 基色 和 | 是 本 贿 商 沾 全 dsPlc3gF SMPS Busk Genwerter 

3 Gimpel PC-LinVMISRA 
4mTouch Diagnostic Tool 上 
5 DMCI - Data Monitor Coptrocl interfsce 
5 Segmented Display Designer | 
7 MPLA8 Macros 所 
8 dsPIC33F SMPS Buck-Boost Converter | 
9 Memery Starter KE 
10 RTOS Viewer 












11 Keeloq Plugin 
12 AN908 ACTIM Tuning imteriace 
13 dspPIH Fer Designer 





dspPIC33FI15GPp304 osb sabIp0 dcnovzc 明 
EPEDEETEEEE ~ = ~ TREE 


Roy SF 不 站 站 十 去 闪 SDRUF -SeE2ITDPRPSEDLSCSRIE2 和 AwayaEOrFY sr 





图 7.2.89 Matlab/Simulink 插件 


本 - 基于 模型 的 设计 一 一 MCU 篇 


选择 此 命令 之 后 ,菜单 栏 增加 了 Matlab/Simulink 这 一 项 目 , 选 择 菜单 项 Matlab/Simu- 
link->~Specify Simulink Model Name, 如 图 7. 2. 90 所 示 ,指定 需要 生成 代码 的 模型 。 


aa 7TSRCTRIS2EZ2 RECTTETETCTRRERDR CE 
区 潜 本 EPE RAR TO ciilsj) -地 号 1 








IE Ed MiasrrProject Debugger programmer Toos on 和 la 
| D 售后 吧 让 中 | Specify Simulink Modesl Name 


ea 本 Wisesnsens TerTerate Code 







-CMR 


Array Snapshot 
Data Capture 

Close Matiab Session 
Help 
Register 
















dsPIC33F)16GP304 oab sablP0 dcnavzc 





7.2.90 指定 Simulink 模型 
指定 模型 并 单 击 确定 ,如 图 7.2. 91 所 示 , 系 统 会 自动 打开 MATLAB 主 窗口 与 模型 窗口 


(为 避免 过 多 占用 系统 内 存 , 用 户 应 在 使 用 该 方法 前 ,关闭 所 有 MATLAB 窗口 ) ,MPLAB IDE 
的 Outpnut 窗口 显示 模型 打开 成 功 , 如 图 7.2.92 所 示 。 


Lookin: call ~ 伟人 闻 y [~ 


办 


Name Type 9ize Date 
本 cc iiModed 22010 
加 ccall_sim Simulink Model 63KB 2010 


上 
Lom_ 
Piles oftype， [MDLRlesfmndl | 


六 Dpen as readonly 


图 7.2.91 选择 模型 





[Bad yesonConuelj FndinFies| Matabieactim | 








enimng Natlab session and model "6:AYJATLAB\book\PICN\callvccall,mdl 
1ease VWalit.. 。 


3UCCEBLEUII7 Recnea Ikhe 基 5del 人 





图 7.2.92 ”Output 窗口 显示 模型 打开 成 功 
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继续 选择 MPLAB IDE 的 菜单 项 Matlab/Simulink->Generate Code, 如 图 7. 2. 93 所 示 。 
网 pueipe ve56 四 










口感 戌 }】 睛 芭 吉 | 丁 玖 孝 弓 路 旦 | Medet Narnei ccaikhmdi “” fixc21d | 
impe 上 tenerategc 和 les | 
Generate Code and Import Files | 
Clese Model 
Array Snapshot 外 
Data Capture 
Close Matlab Session 
HelP 





Regisier 





人 


dspIC33R16Gp304 oab iabJpO dcnovzc 


图 7.2.93 选择 Generate Code 命令 
等 待 一 会 后 ,系统 自动 打开 MATLAB 的 代码 生成 报告 ,如 图 7. 2. 94 所 示 。 


7 了 担 nclade “ccall,h" 








1 #include “ccal1l private.h” 
Contents 15  ##incluae 《dec。 cy> 
Summary 了 三 
c R 7  _FWDTIFWDTEN_OFF) 
Subsystem RepeKt 了 如 _FOSC (FECKSN_CSDCNDAOSCIOFNC_ONAPOSCID_ HS) ; 
code Interface Repo 绪 J5  _FOSCSEL (FNOSC_LPRC&IE3S0_0BN) : 
Traceabiltky Report 20  _F6SIC3S_OFFAGCP_OFFAGWRP_ OFF) : 
NERO 2  _FICD(UICS_PGD1) ; 
we 二 rt_OneStep f) 
[-] Model files 加 17e Imrferirupt5 态 eFe 册 / 
ccallc 2 
25 AU SETVB PEF Context 访 Pre 站 负 mece5sa5t7) 册 / 
ccallb 安 太 sk 页 =e 站 at ye TI 而 Br Dr TIntferrapt 态 eFe 贞 / 
ccall_prrvateh 38 ccall_ step() ; 
中 太 
ccall types.h ee _ 
了 zt Gef 让 DGEeT Drfputfs 方 BIFE WW]/ 
[] Utility filles 汪 7 
73 7 了 TS5SpPIe Inferrupt5 矶 Pie 出 / 
77 7U 站 5fOTB 天 PRI7 COmEeXK 方 Ere 后 闻 站 ECE55SGEJC 此 / 
[-] Interface fles 好 wy ET5575 Intferrupt5 看 EFe 风 / 
7 
autobuild.h we 
[-] Dther flles 77 int16T mainfvzoid) 
慷 【 
各  PLLFHED = 0 /or 下 二 8 
main.c 站 CLKDTVbits,PLLPOST = 0: ir 有 二 2 
下 本 有 rmIVbits.ELLPRE = 0， 有 二 





图 7.2.94 代码 生成 报告 


之 后 MPLAB IDE 的 Output 窗口 显示 图 7. 2. 95 所 示 的 信息 ,说 明代 码 编译 成 功 ,但 该 代 
码 不 能 直接 使 用 ,还 需要 必要 的 修改 。 


ss 
5 s 
绽 区 
生 
轴 


国 : 基于 模型 的 设计 一 一 MCU 篇 


[Buid_] VersionConuol| FndinFles| MatLabineacm | 
jheap 0 0 《0) 
|stack 0xg04 0Dx7Tfc 《20d44) 





JiLaximum dyramic 机 EmoIY (bytes); 0xTfc 【20d44) 


jw#k Created “executable": ,.\, .ccall,cof 
jpic30-bin2hex -onf=coff ..\ 必 ./ccall.cof 
| 淋 # 术 Successftul comnplLetior of JIcrochip Enbedded Target bulld procedure for nodel: ccall 


[ec) | 
上 上 一 -一 一 - -一 一 一 一 -一 
| 0 0 (0) 


jstack 0x80d4 0xTfc 【2044) 
aximum dyriamic memory (bytes): 0xTfc 【2044) 


"xx# Created "executable": .,.\, .ccall.cof" 


1 Euias 到 sj 


jpic30-bin2hex -omf=coff .,\. .yccall. cof 
村 # Successful conmpletion of Jicrochip Embedded Target build procedure for mo 
时 皇 车 下 ECTTIOD CDOTD CONPEETE3 
4 [Escsaais 且 au + 


7.2.95 Outpnut 窗口 信息 


在 MPLAB IDE 环境 下 ,新建 基于 dsPIC33FJ16GP304 的 工程 ,并 加 入 先前 生成 的 各 代码 
文件 以 及 调用 的 C 代码 dec. c, 如 图 7. 2. 96 所 示 。 









ccall - MPLAB IDE v8.56 - ccallmcw . 
| Fle Edit View project Debugger Programmer Tools_Configure Window Help 





D 节 品 } 若 记 | 殷 由 内 夺 霹  | [Debug rr 咏 园 肥 四 @@| 作 固 加 
Checksum: 0xc21d 





】 东 


人 










四] ccal_private:h 
ib] ccall_types,h 
外] rtwtypesh 
外 Object Files 
[L] Lbrary Fies 
上 Dinker Script 
|. 辐 other Fies 
















”dspiC33Fjl6GP304 





图 7.2.96 建立 MPLAB 工程 
打开 main. c, 找 到 以 下 代码 并 按 注释 说 明 修改 


放 
让 xz、 
乌 
区 一 
上 1 
贡 
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井 include "ccal1.h" 
井 include "ccall_private.h" 
1// 井 include < dec.c> /7 删除 该 行 


站 


打开 ccall.c, 找 到 以 下 代码 并 按 注释 说 明 修改 : 
井 include "ccal1.h" 
井 include "ccal1l_private.h" 
extern int dec(); // 增 加 该 行 ,用 于 外 部 函数 声明 
/ * S-Function(〈(dsPIC_portRead_sfun) : < Root >/Read Port Input 玉 " 关 / 
/rtb_cCall = PORTR; // 删 除 该 行 
rtb_cCall = PORTA; // 修 改 为 rtb_cCall = PORTR>>7; 


Buid 【Version Conuol[ FndinFies[ MatLabinteaciomnl 
0x802 0 0x2 (2) “^ 





Total data Imemory used (bytes): 0xd4 (4) 《1 邹 


Dynamic Memory Usage 


region adqddress maxzimum length (dec) 
heap 0 0 (0) 
|stack [zxz804 Drfc 【〔2044) 

Maxznmum dynamic memory (bytes): 0x?fc (2044》) 


xecuting: “C:\Program Files\JicrochipYIPLAB C30\binxpic30-bin2hex. exe” “6G:NVJNATLAE\bool 

| 拭 oaded G:XIATLAB\book\PIC\callvcallvcall, cof， | 
ljDebug build of project “6G:AWJIATLAB\bookYPICY\callvcallvcall.mcp” succeeded. 
Language tool versions: plc30-as. exe Vv3. 23，Pplic30-gcc. exXe YY3,. 23，plic30-1d. exe V3. 23， ?可 | 
reprocessor Symbol  __DEHUG” is defined. 
ijSun Sep 05 23:04:31 2010 


+ 址 
时 . 
2 
2 | 
二 
了 





图 7.2.97 编译 信息 


s. 虚拟 硬件 测试 
搭建 proteus 模型 ,加 载 生 成 的 HEX 文件 。 执 行 仿真 后 , 即 得 到 与 功能 验证 模型 一 致 的 
结果 ,如 图 7. 2.98 所 示 。 
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YCAPVDCDCORE 


































RCBKN20RP24 AYSS 
RCc7iN1I7RFP23 AYDD 1 + | C Cl 
RC6KCN1BRP22 
RCSNCN26RP21 RB1SKCN11ARP15IAN9 
RC4 人 LN25RP20 RB14MCN12RP14IAN10 100F 100nF 
RC3NICN26RP19 RB13MCN13FRP13IAN11 
PRCc2MCN10FRP18/ANB RBI12MCN14RP12IAN12 
RCINCNSRP17IAN7 RB11 大 NISRP11PGEC2 
RCOCNSIRP16IAN6 R610CNIGRP10PGED2 
RBSCN21RP9SDA1 
RA10TMS RBBCN22RPBSCL1 
RA9SATDI RB7 人 CN23RP7HMNTDO 
RABTDO FEB6NCN24FP6IASCL1PGEC3 
RATITTCK FRBSKCN27RP5MASDA1PGED3 
RA4KNOIT1CKSOSCO RB4KN1 有 要 P4ASOSCI 
RA3SNCN2SNCLKOASCD RB3KCN7IRP3AUN5 
RA2KN3SDOICLKUDSOI RB2KNSRP2AN4 
RATAN3MYREF -AN1 RB1CN5RP1NC2IN+IAN3PPGEC1 





RADONCN2MVREF */AND RBOKXCN4RPONC2N-IAN2IPGED1 









NMCLR 











1 354， 























、 VCAPJVDDCORE 
被 加 数 RcaKNigRp2s 
RCBCN20RP24 AYSS 
RCTACNI7RP23 AYDD 
RC6KCN1BRP22 
RC5ACN26JRP21 RB15SACN11IRP15/AN9 
RC4KCN25RP20 RB14CN12RP14/AN10 10F 100nF 
RC3KCN26RP19 RB13/CN13RP13IAN11 
RC2MCN1ORP18JANB RB12CN14RP12/aAN12 
RCTCN9RP17AAN7 RB11KCN15RP11PGEC2 
RCOCNBRP16AANG RB10KCN16IRP10PGED2 
RESICN21/RP9/SDA1 
RA1QITMS RBBANCNZ22FRPBISCL1 
RASATDI RG7ACN23RP7MNTO 
RABITDO RB6XCN24IRP6IASCL1PGEC3 
RA7TTCK FB5/CN27/RP5/ASDA1APGED3 
RA4ACNOTICKISOSCO RB4ACN1RP4ASOSO 
RA3ACN29ICLKODSCO RBGACN7RP3UANS 
RA2ACN3OCLKIOSOGI RB2MCNSRP2AN4 
RA1ACN3SMYREF -AN1 RB1CNSRP1C2IN+IAN317PGEC1 
RADACN27YREF AND RBOCN4 有 RRPOC2N-IAN2iPGED1 











图 7.2.99 仿真 结果 
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7.3 无 对 应 模块 时 的 应 用 


Microchip 公司 提供 的 dsPICBlocksets 赛 括 了 dsPIC 芯片 的 所 有 外 设 , 用 户 可 以 方便 地 
利用 这 些 模 块 进行 开发 工作 , 据 弃 坦 的 开发 方法 。 但 是 考虑 到 Blocksets 并 非 免费 ,会 有 部 分 
用 户 不 能 使 用 这 款 软 件 , 也 无 法 使 用 dsPIC _stf. tlc 模板 ,这 是 否 意味 着 就 不 能 用 基于 模型 的 
方法 进行 开发 呢 ? 

其 实 不 必 担 心 , 用 户 还 可 以 使 用 RTW 提供 的 ert. tic 模板 。 这 样 , 开 发 工作 中 只 是 外 围 
设备 的 驱动 程序 需要 用 户 手工 编写 ,而 最 重要 的 核心 算法 仍然 可 以 用 基于 模型 的 方法 完成 ,但 
代价 是 代码 的 效率 会 有 所 降低 。 


7.3.1 创建 功能 验证 模型 


图 7. 3. 1 所 示 的 乘法 模型 完成 了 简单 的 两 数 相 乘 ,并 将 其 百 . 十 .个 位 分 别 显示 的 功能 , 根 
据 第 2 章 的 内 容 , 容 易 建 立 此 模型 。 其 中 c 表示 百 位 ,b 表示 十 位 ,a 表示 个 位 。 





图 7.3.1 功能 验证 模型 
其 中 split 是 Embedded MATLAB 模块 ,完成 分 离 百 .十 .个 位 的 功能 。 


function [c,b,a] = split(u) 


先 井 eml 

a = renm(uy10); // 计 算 个 位 
b = (rem(u,100) -a) / 10; /7 计算 十 位 
c = (u-10x*b-a) /100; // 计 算 百 位 


7.3.2 自动 代码 生成 


在 模型 中 添加 模块 库 Smulink / Logic And Bit Operations 中 的 Shift Arithmetic 和 Bitwise Op- 
erator, 在 模块 库 Simulink / Ports 愉 Subsystems 中 找到 输入 模块 与 输出 模块 ,替换 Const 和 Generic 
LED 模块 ,如 图 7. 3. 2 所 示 ,并 将 这 些 端口 和 Product 模块 的 数据 类 型 修改 为 uint16。 


ES “355 中 ， 


基于 模型 的 设计 一 一 MCU 篇 








1 内 rithmmetic1 





split Bitwise 
Operator 


图 7.3.2 代码 生成 模型 


打开 c 端口 处 的 Arithmetic 模块 ,在 Number of bits to shift right 中 输入 一 8 ,将 百 
位 数字 向 左 移 8 位 ,如 图 7. 3. 3 所 示 。 


副 Function 8lock Penefnghers: Shi Arithmnetic el | 


This block car aritlmeticslly shitt the bits the Wi | 
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图 7.3.3 算术 移 位 模块 设置 
打开 b 端口 处 的 Shift Arithmetic 模块 ,在 Number of bits to shift right 中 输入 一 4, 将 十 位 数字 


向 左 移 4 位 ,如 图 7.3.4 所 示 。 
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打开 Bitwise Operator 模块 ,设置 为 或 运算 (or) ,禁用 Use bit mask 功能 ,将 输入 端口 个 
数 设置 为 3 个 ,如 图 7.3.5 所 示 。 





哆 Function Block Parameters: Bitwise Operator 





| Bitwise Operator (mask) (link)》 


| Perfornm the specified blitwise 0perat1lon on the 
lnputs，The output data type should represent zero 
eXact1Ty.。 


Parameters | 





| 
Operator: IOR | 
Use bit masEK ,,， 
| 


| 
| Number of input ports: | 
3 | 


oOE | [cancel ] [Help 





图 7.3.5 Bitwise Operator 模块 设置 


使 用 Shift Arithmetic 和 Bitwise Operator 模块 的 目的 在 于 将 3 个 数据 集中 到 一 个 端口 
上 输出 ,提高 硬件 资源 的 利用 率 。 计 算 结 果 的 百 位 位 于 寄存 器 的 第 11 一 8 位 ,十 位 位 于 寄存 器 
的 7 一 4 位 ,个 位 位 于 寄存 器 的 3 一 0 位 。 
打开 模型 的 参数 设置 对 话 框 , 在 Solver 界面 中 ,设置 求解 器 为 定 步 长 离散 求解 器 ,如 图 7.3.6 
所 示 。 
Solver options 


Type: | Fixed-step | Solver: discrete (no continuous states) | 








Fixed-step Size (fundamental sample time)}: auto 


图 7.3.6 求解 器 设置 
在 Report 界面 中 , 勾 选 所 有 复 选 框 , 便 于 后 期 检查 及 跟踪 如 图 7. 3.7 所 示 。 


J create code generation report yj| Launch report automatically 
Navigation 


Yi Code-to-model 


y| Model-to-code 


Traceabihity Report Contents 
中 Eliminated /virtual blocks 
局 Traceable Simulink blocks 
ITraceable Stateflow objects 


IVI Traceable Embedded MATLAB functions 


图 7.3.7 报告 界面 设置 
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打开 模型 的 参数 设置 对 话 框 ,在 Hardware Implimentation 界面 中 ,设置 器 件 类 型 为 dsPIC, 如 
图 7. 3. 8 所 示 。 


Embedded hardware (slmulatlor and code generatior) 


人 人 人 
Devlce Vendor: 了 icrochip 





DevwIce type: dsPIC 四 





图 7.3.8 选择 芯片 
在 Real-Time Workshop 界面 中 ,设置 TLC 文件 为 ert, tlc, 如 图 7.3.9 所 示 。 


Target Sejection 


System target 侧 e; ert.tic Browse.-。 | 


Language: C zj 
Description: Real-Time Workshop Embedded Coder 


图 7.3.9 设置 TLC 文件 
单 击 模型 工具 栏 的 按钮 当 ,生成 代码 的 报告 如 图 7. 3. 10 所 示 。 
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图 7.3.10 代码 生成 报告 


在 MPLAB 中 建立 工程 ,将 自动 生成 的 代码 添加 到 工程 中 ,由 于 使 用 的 是 ert. tlc 模板 , 代 
码 并 不 能 直接 使 用 ,需要 在 ert_main. c 中 作 如 下 修改 : 


//# include < stdio.h> /# 去 掉 该 行 * / 

# include "times_code.h" /# 模型 头 文件 * / 

## include "rtwtypes.h” / * MathWorks 数据 类 型 */ 

井 include " p33FJ16GP304.h" // 添 加 dsPIC33FJ16GP304 头 文件 
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/ *#* Save FPU context here (if necessary) #*/ 


/ * Re-enable timer or interrupt here x / 


1/ # Set model inputs here 关 / 
times_code_U. Inl = PORTC; 
times_code U. In2 = PORTR >> 7; 
1/ # Step the model #/ 
times_code _ step() ; 
/ * Get model outputs here # / 
PORTB = t+imes_code Y. Outl; 
int_T malin(); 
int_T main() 
{ 
1/ x Initialize model x / 
times_code_ initialize(); 
TRISR = 0x7ff; 
TRISB = 0; 
TRISC = 0x3ff; 
while(1) 
{rt_OneStep();} 


// 删 除 下 列 代码 


// 模 型 输入 口 与 硬件 相关 联 
// 模 型 输入 口 与 硬件 相关 联 


// 模 型 输出 口 与 硬件 相关 联 


// 删 除 不 必要 的 输入 参数 
// 删 除 不 必要 的 输入 参数 


// 指 定 R 端口 为 输入 
// 指 定 B 端口 为 输出 
// 指 定 C 端口 为 输入 


// printf(" Warning: The simulation will run forever.” 
// "Generated FERT malin won't simulate model step behavior. " 


// "To change this behavior select the 'MRT-file logging" option.Nn ") ; 


// fflush(CNULL) ); 


保存 所 有 修改 ,再 次 编译 工程 ,Output 窗口 得 到 以 下 信息 ,说 明 编 译 成 功 (图 7. 3. 11) 。 
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图 7.3.11 编译 信息 
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7.3.3 虚拟 硬件 测试 


本 例 利用 dsPIC33FJ16GP304 芯片 实现 乘法 的 输入 与 显示 ,参考 第 5. 1 节 的 内 容 , 搭 建 出 
图 7. 3. 12 所 示 的 原理 图 。 
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ETTEETITCTET 
7.3. 12 Proteus 原理 图 


第 一 个 输入 数据 从 RC0 一 RC3 引 脚 进 入 芯片 ,第 二 个 数据 从 RA7 一 人 RA10 引 脚 进入 芯 
片 。 由 十 进 制 与 二 进 制 的 关系 可 知 ,输入 数值 的 范围 为 0 一 15。 

数码 管 的 百 位 和 RB8 一 人 RB11 引 脚 连接 ,十 位 和 RB4 一 RB7 引 脚 连接 ,个 位 和 RB0 一 人 RB3 
引 脚 连接 。 

重新 编译 后 ,利用 Proteus VSM 进行 调试 ,输入 数据 为 1001.1101, 对 应 的 十 进 制 数字 为 
9、13, 可 以 看 到 输出 结果 显示 为 117 ,实现 了 模型 的 预期 功能 ,如 图 7. 3. 13 所 示 。 
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7.3.13 仿真 结果 
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开发 ARM 处 理 器 程序 的 方法 有 两 种 :有 操作 系统 的 程序 设计 ;无 操作 系统 的 程序 设计 ， 
即 裸 机 一 一 单片机 开发 方式 。MathWorks 公司 在 MATLAB R2010a 就 开始 引入 基于 Eclipse 
的 开发 和 Linux 操作 系统 ,支持 除 Cortex 系统 以 外 的 所 有 ARM 芯片 。 在 刚 发 布 的 MATI- 
LABR2010b 版 中 ,不 但 引入 了 Vxworks 操作 系统 ,还 增加 了 对 ARM Cortex 系列 芯片 的 支 
持 。 本 章 仅 讨论 无 操作 系统 的 基于 模型 设计 的 ARM 开发 。 考 虑 到 有 些 读者 可 能 没有 具体 的 
硬件 设备 ,这 里 仅 就 Porteus 虚拟 硬件 平台 支持 的 NXP ARM7 进行 介绍 ,其 他 型 号 ARM 芯 
片 的 裸 机 开发 与 此 完全 类 似 。 还 有 ,本 章 所 举 的 实例 仅仅 是 为 了 增加 读者 的 观赏 性 ,ARM 处 
理 器 的 应 用 领域 远 不 止 这 些 ,对 于 其 他 领域 的 应 用 ,读者 可 根据 实际 情况 借鉴 本 章 的 思想 进 
行 。 对 于 目前 流行 的 低 功 耗 .高 效率 的 新 一 代 ARM 芯片 Cortex 系列 ,在 作者 的 后 续 书 中 将 
专门 讨论 。 

本 章 的 主要 内 容 : 

@ ARM 简介 。 

@ 蜂 鸣 器 。 

@ 交通 灯 控 制 。 

@ 步 进 电动 机 控制 。 

@ 无 刷 电动 机 控制 。 


8.1 ARM 简介 


ARM 是 Advanced RISC Machines 的 缩写 ,是 一 家 专门 授权 IP( 知 识 产 权 ) 给 全 球 众 多 
著名 半导体 、 软 件 和 OEM 厂商 ,并 提供 服务 的 英国 公司 。 其 产品 包括 ARM7、ARM9、 
ARM10 ARM11 ,目前 最 新 型 的 是 ARM Cortex 系列 。 下 面 就 本 章 用 到 的 ARM7 TDMI-S 芯 
片 作 简单 介绍 。 

ARM7 TDMI-S 是 通用 的 32 位 微 处 理 器 , 它 具 有 高 性 能 和 低 功 耗 的 特性 。ARM 结构 是 
为 基于 精简 指令 集 原 理 而 设计 的 。 使 用 一 个 小 的 .廉价 的 微 处 理 器 核 , 便 可 得 到 很 高 的 指令 吞 
吐 量 和 实时 的 中 断 响应 。 采 用 流水 线 技术 ,在 执行 一 条 指令 的 同时 对 下 一 条 指令 进行 译 码 , 并 
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将 第 三 条 指令 从 存储 器 中 取出 。ARM 处 理 器 同时 包含 了 ARM 指令 集 和 THUMB 指令 集 ， 
THUMB 指令 特别 适用 于 存储 容量 小 ,代码 密度 大 的 场合 。LPC2103 是 一 款 基 于 ARM7 TD- 
MI-S 体系 结构 的 ARM7 芯片 , 它 的 主要 性 能 如 下 : 


TRST TCKTCITDO XTAL2 ”Vopev3) 


XTALI| TST Vppuve) 
LPC2101/2102/2103 喇 硬 时 村 
测试 /调试 结果 
PO [34 ;0] 
ARM7TDM-S 





8SKB/6KB/ 
32KB SRAM 
EINT2 到 
SCLOSCLHI 
EINTO0 {1) 
3XCAPOCI) SDAoSDAILD 
4XCAPHI 
| 捕获 /比较 外 部 计数 器 SCK0SCKI(I 
4XMApII 二 定时 器 0，1，2，3 SCKNMD 
3XMAP2N| = es MOosio.MOSIIC) 
4XMAP3(D) MISOOJMISOO1D) 
SSELOSSELIG) 
ANIT-ATNO(1) TxpoTXDID 
RXDORXDI(D 
DSRILCTSILRTSL， 
PO [34:0] DTRIJDCDIRII 
C2 


看 门 狗 定 器 


图 8.1.1 LPC2103 结构 图 

(1) 16/32 位 ARM7 TDMI-S 微 控制 器 , 超 小 LQFP48 封装 。 

(2) 8 KB 的 片 内 静态 RAM 和 32 KB 的 片 内 Flash 程序 存储 器 。128 位 宽度 接口 /加 速 
器 可 实现 高 达 70 MHz 工作 频率 。 

(3) 通过 片 内 boot 装载 程序 实现 在 系统 /在 应 用 编程 。 单 个 Flash 扇 区 或 整 片 擦 除 时 间 
为 100 ms。256 字 节 编程 时 间 为 1 ms。 

(4) 让 入 式 ICE RT 通过 片 内 RealMonitor 软件 提供 实时 调试 。 

(5) 10 位 A/D 转换 器 提供 8 路 模拟 输入 ,以 及 特定 的 结果 寄存 器 来 最 大 限度 地 减少 中 断 
开销 。 

(6) 2 个 32 位 定时 器 /外 部 事件 计数 器 ( 带 7 路 捕获 和 7 路 比较 通道 ) 。 
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(7) 2 个 16 位 定时 器 /外 部 事件 计数 器 ( 带 3 路 捕获 和 7 路 比较 通道 ) 。 

(8) 低 功 耗 实时 时 钟 (RTC) 具 有 独立 的 电源 和 特定 的 32kHz 时 钟 输入 。 

(9) 多 个 串 行 接口 ,包括 2 个 UART、2 个 高 速 下 C 总 线 .SPI 和 具有 缓冲 作用 和 数据 长 度 
可 变 功 能 的 SSP。 

(10) 向 量 中 断 控 制 器 (VIC) ,可 配置 优先 级 和 向 量 地 址 。 

(11) 多 达 32 个 通用 IVO 口 。 

(12) 多 达 13 个 边沿 或 电 平 触发 的 外 部 中 断 引 脚 。 

(13) 通过 一 个 可 编程 的 片 内 PLL 可 实现 最 大 为 70MHz 的 CPU 操作 频率 ,其 具有 10 一 
25 MHz 的 输入 频率 。 

(14) 片 内 集成 振 划 器 与 外 部 晶体 的 操作 频率 范围 为 1 一 25MHz。 

(15) 低 功 耗 模式 包括 空闲 模式 、 掉 电 模式 和 带 有 效 RTC 的 掉 电 模式 。 

(16) 可 通过 个 别 使 能 /禁止 外 围 功 能 和 外 围 时 钟 分 频 来 优化 额外 功 耗 。 

(17) 通过 外 部 中 断 或 RTC 将 处 理 器 从 掉 电 模式 中 唤醒 。 

读者 想 了 解 更 多 的 LPC2103 微 控制 器 的 信息 请 阅读 参考 文献 或 查阅 NXP 官方 网 站 上 的 
数据 手册 。 


8.2 蜂 鸣 器 


8.2.1 蜂 鸣 器 发 声 模型 


蜂 鸣 器 内 部 的 振动 膜 片 在 电磁 线圈 和 磁铁 的 相互 作用 下 ,周期 性 地 振动 发 声 。 由 此 可 知 ， 
脉冲 信号 即 可 驱动 其 电磁 线圈 ,发 出 蜂 鸣 声 。 根 据 第 3 章 的 介绍 ,容易 建立 蜂 鸣 器 的 State- 
flow 模型 ,如 图 8. 2. 1 所 示 。 

其 中 数据 io0set ,io0clr 表示 生成 的 脉冲 信号 ;pinselo ,io0dir 为 芯片 端口 的 状态 设置 ;flag 
表示 高 低 电 平 间 的 转换 条 件 标 志 ;key 控制 蜂 鸣 器 是 否 工 作 , 如 图 8. 2. 2 所 示 。 

虽然 ARM 系列 芯片 已 经 集成 了 PWM 功能 ,但 这 里 为 了 验证 基于 模型 设计 的 可 行 性 ,此 
例 采 用 软件 方式 产生 PWM 信号。 


























| pinsel0=0: Name Scope Port Resolve Signal DataType 
| io0dir=1; | own 
en : en: [ ] pinselg Dutput 1 double 
io0set= fag== = 
io0cilr=0 sa 国 ] ioodir Output 2 double 
四 本 [iooset Output 3 double 
kkey== 介 [key==g] [ 国 ioockr output 4 1 doubie 
beepoff 国 ] key input 1 double 
gdirs0 
RN [ 国 fag Input 2 double 
8.2.1 蜂 鸣 器 发 声 模型 图 8.2.2 蜂 鸣 器 发 声 模型 数据 列表 


555 : 


柄 四 基于 模型 的 设计 一 -MCU 篇 


8.2.2 蜂 鸣 器 功能 验证 模型 


完成 蜂 鸣 器 发 声 模型 之 后 ,在 Simulink 模块 库 中 找到 图 8. 2. 3 .图 8. 2. 4 所 示 模 块 ,并 按 
图 8. 2.5 连接。 
| 上 Pors 8 Subsystems = | 
| -.Sionalattrputes Wodel-Wide UtiJitles | = 
-SignalRouting | | 了 orts 和 Subsystems L_ 
1 Sinys | ) Signal Attributes 和 
se | Cn 


Pulse Gereratcr 





Im ， 重 二 过 全 、 
[Sources 
User-Defined 了 unctions 


PPUser-Defned Functons 
j #j 闪 ddiional Math 玉 DiScrete 
+- 阴 上 Er0Space BloCkset 


图 8.2.3 脉冲 发 生 器 模块 图 8.2.4 示波器 模块 





Pulse 
Generatof Chart MMR 


图 8.2.5 功能 验证 模型 
选择 模型 主 窗口 的 菜单 项 Simulation~>Configuration Parameters. . . ,打开 模型 参数 对 话 


框 , 在 Solver 面板 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 8. 2.6 所 示 。 
Constant 模块 将 值 设 为 1, 使 模型 处 于 beepon 状态 ;Pulse Generator 模块 产生 脉冲 ,使 


flag 不 断 变化 。 
运行 模型 ,可 以 看 到 io0set 端口 输出 了 脉冲 信号 ,如 图 8. 2. 7 所 示 。 
[RE 
-LI 疝 万 基本 加 归 8 和 | 
| 
| 
Solver options 


mpe sr ER 


Fixed-step Size ff 和 ndamental sample time}: 0.01 





race 
图 8.2.6 求解 器 设置 图 8.2.7 仿真 结果 


EGR 
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8.2.3 软件 在 环 测试 


软件 在 环 测 试 (SIL) 是 在 主机 上 对 仿真 中 生成 的 函数 或 手写 代码 进行 非 实 时 性 联合 仿真 
评估 , 当 软 件 组 件 包 含 需要 在 目标 平台 上 执行 的 生成 代码 和 手写 代码 的 组 合 时 ,应 该 考虑 进行 
软件 在 环 测 试 ,完成 对 模型 生成 代码 的 早期 验证 。 

软件 在 环 测 试 不 需要 硬件 ,只 是 对 算法 代码 进行 测试 ,具体 做 法 是 对 要 进行 测试 的 子 系统 
编译 可 生成 SIL 模块 ,比较 原 模 块 与 SIL 模块 的 输出 ,以 此 确认 算法 的 正确 性 。 

在 模块 库 Simulink / Ports &Subsystems 中 找到 输入 /输出 模块 ,替换 图 8. 2.7 中 的 脉冲 
信和 号 源 与 常量 输出 ,并 将 这 些 端口 的 数据 类 型 修改 为 uint32, 如 图 8. 2. 8 所 示 。 

另外 还 需要 确保 Stateflow 模型 中 数据 的 类 型 也 应 为 uint32, 如 图 8. 2.9 .图 8. 2. 10 所 示 。 





Name BlockWype CutDataType3r OutMin DutMax Lodccale DataType 
算 Moda werkerp 
总 Code ior am 
光 Adwmce toram 
知 confguraicon 
号 ml 
驹 char 
局 outi 8 
局 out2 8 
已 ou [ 
已 Dut4 间 
ee [ 
图 8.2.8 代码 模型 图 8.2.9 修改 模型 端口 数据 类 型 
Name Scope Port Resolve Signal Datafype Sze Inmbalvalue CompiledType Complle 

国 ] plnselO Out.， 1 

[ 国 ioodi Out.， 2 

[ 国 iooset Out .3 

国 ] iooch Out 4 

国 key Input 1 

四 ] fag Input 2 





图 8.2.10 修改 模型 内 部 数据 类 型 


Report 界面 , 勾 选 所 有 复 选 框 , 便 于 后 期 检查 及 跟踪 ,如 图 8. 2. 11 所 示 。 
在 Real-Time Workshop 界面 ,设置 TLC 文件 为 ert,tlc, 如 图 8. 2.12 所 示 。 


刀 Create Code 9eperation report 7 Launch report autornaticalhy 

Nawgation 

Codetornodel 

一 | wo 

Ce Target Sejection 

Traceabgty Report Contents 3 
页 Elminated | virtual blocjs System target file:; ert.tkc BFowSse..， 
7 Traceable Simulink blodcs 外 

VY Traceable Statefiow objecs EPE [> 2 

J Traceable Embedded MATLAB functions Description: ReaFTime Workshop Embedded Coder 

图 8.2.11 报告 界面 设 定 图 8.2.12 设置 tjc 


雹 - “365 本 : 


醒 = 基于 模型 的 设计 一 MCU 篇 


打开 模型 的 参数 设置 对 话 框 ,在 Real-Time Workshop->SIL and PIL Verification 界面 ， 
勾 选 Create SIL block 复 选 框 ( 图 8. 2. 13) 。 
之 后 按 下 模型 工具 栏 的 当 按 钮 ,生成 SIL 模块 (图 8. 2. 14) 。 


Software-ifmrthe-loop (SIL) and processor-inrthe-ioop (PEL) ver 布 cation 





门 Enable portable word szes 
Generate Ver 币 cahon blocks 
加 Create SR blodk 
Code coverage 
(Code COVerage tool: Non rfigure COVver8BgE 
RTW S$-Function 
8.2.13 SIL 设置 图 8.2.14 SIL 模块 


如 图 8. 2.9 所 示 , 以 SIL 模块 替换 Stateflow 模块 ,重建 图 8. 2.15 所 示 的 验证 模型 。 由 于 
SIL 模块 是 根据 定点 模型 建立 的 ,因此 各 端口 间 加 入 了 数据 类 型 转换 模块 。 





Generator RTW 9S-Function 


图 8.2.1S SIL 测试 模型 
该 模型 的 运行 结果 如 图 8. 2. 16 所 示 ,与 Simulink 功能 验证 模型 的 结果 一 致 。 


-~ TY 


S 四 网 PP 几 加 加 日 总 所 = 








图 8.2.16 仿真 结果 


8.2.4 自动 代码 生成 


打开 模型 的 参数 设置 对 话 框 , 在 Hardware Implimentation 界面 ,设置 器 件 类 型 为 ARM 
7, 如 图 8. 2. 17 所 示 。 


.366，。 
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Device vendorXiARI Coapatible | Dewice type: 


mber of bits Largest at0aIC SiZ74 








上 
3 





上 ~-~- rr integer; Char 


long: j32 float: | 访 double; 上 全 
Eloati int: ,one 
native: 于 pointer: 52 | 人 


图 8.2.17 选择 芯片 
单 击 模型 工具 栏 的 按钮 六, 生成 代码 的 报告 如 图 8. 2. 18 所 示 。 


人 


ak】 Fn | File: TD:VEATLAE FILESVarm beepVarm beep_ert_rtm\Vert_pain 避 


1 间 
避 二 7 TU 
Summary 让 
-Jiae 的 演 Shop 2ede Cenriased for 六 RU Wode aa: 


9 本 
> 
只 
ceoevL see 上 wv-uvSwvw 


Perl5ion 7 
了 ea RSCO cj- 了 iae 加 95 后 yecgian RU 拓 1on-17 
map 和 # 各 本 -9 ye enerated an - Sn 2p 上 中:2 加 育 
Generated Files 下 5 So :着 
f-] Main 人 ie 原 下 52 届 诈 12ne7ars 咎 7 8 2 了 12 341 
站 PR 1 站 3 3 Mr IF 
[-] Model files 本 下 ina vag 全 5 RE Xp88 了 
下 W er43TET 057957 4 了 PACST 
an te 皮 4 on 2 
anp_jxseph 引 凶 
amm baep_privatah 和 
玫 “和 0) 1 EAI 0r PITEEFFTSI ) 
MT bwD iD 后 Niea bo AN 
Utility Wes (1) 瑟 人 ncjsie “rtwt7pezh 有 人 1 
wa Aeronrysrl 上 Unytn Te- rc 过 61 lntere FnTO9 TTS1039 
| 1 本 和 er er coae “Trent 了 nctan Tt CeSreP 15 
2 SR 6253 们 请 二 ja 1 0 二 3 0 办 1 有 有 at 08 De 了 
党 Fo 1 5 Fafe 1 JPFIFE3 全 8 EC 00 加。 到 必 /而 3 吉 7 
07 JI7UDIT SI 门 RAIN JU 0 If5h0T re Moref We DTm 1 
胃 上 MaDJe ed ipdpetny ai th 3 iair ar 121 1 OCT 
多 * tr ienefafed ca 5tep fnttI0， fyrran heieryer jhoujd ap Tallcrez fu 
》 JS 帮 Piirericn mod 及 TI9 rapjz IE Met 80 ep7TO7 5tafa7 kr e 
y Feel-foer mntej and :etirnz 人 7na 2 ineitepm 
人 记 
mW 则 于 Crestinoidi 
_ 如 轴 刘 三 OneStegfnosdh) 提 


TransSTE vv Ps 
WAWrAvTYYYYreEviciwnttO en oueeaiRvEiaceann 肌 as ieae arceee TacEaoEwacauEEveaSae 


图 8.2.18 代码 生成 报告 
1. 建立 Keil 工程 


打开 Keil uVision4, 芯片 选择 LPC2103 ,建立 工程 ,并 加 入 生成 的 代码 ,如 图 8. 2. 19 所 示 。 


六 beep - bVison4 
盖 一 


红 隐 Yew Baed Fi Debeg Pepperak Joou 2 节 rdow betp 


Ye 


二 


- Real-Tims Mozyshop 
民 轩 wm_beep< 
上 国 etmainc 


Mael "ezal05 2 和 , 驴 
eaI-T9e Worksmop -An 
heal1-73c Worxkyxhap ， on 1 aon rn 53556034 20 冯 
TZC vexa3xoy ) 了 5 (6 9 2039 


CrCr+ 305zee 3Od Den5FE54 以 OF 1 3 368 2 93 二 33 2 


ar9e7 selecrjiosi 5 
Psddr3 gs 3elscc1205 NM Sowgacihle ARK ?了 


庙 wm mrmmonrtaww wefvamgwmwrr Te np an ws 央 


mg 
0 ; 
003 
004 
005 
0 
吕 
0 
砚 
00 
Wi 
0 
人 3 





图 8.2.19 Keil 工程 


国 - 基于 模型 的 设计 一 一 MCU 篇 
代码 并 不 能 直接 使 用 ,还 需 在 ert_main. c 中 作 如 下 修改 : 


本 


// #include <stdio.h> /x* 在 后 面 的 代码 中 删除 了 天 数 printft/fftlush, 因 此 不 再 需要 stdio.h #*/ 


井 include "arm beep.h"” /# Model's header file x / 
井 include " rtwtypes.h" / 关 MathWorks types #/ 
划 include < LPC21XX. 日 > /xx 添加 DLPC21XX 头 文件 * 7/ 


/x* 手 工 添加 Timer0 的 终端 服务 程序 * / 
void _irqflagCvoid) 
《 
ift(arm beep _U. In2 == 0) arm_ beep U,. In2 = 1; /flag 痢 1 


else arm_beep U. In2 = 0; /flag 哮 0 
TOIR = 0x01; // 清 除 中 断 标 志 
VICVectRadar = 0x00; // 通 知 VIC 中 断 处 理 结束 


} 
/* 手 工 添加 Tiner0 的 初始 化 代码 * / 


void Timer0Init(volid) // 初 始 化 定时 器 0 

{ 
TOPR = 99; // 设 置 定时 器 分 频 系 数 为 100 
TOMCR = 0x03; // 匹 配 通 道 0 匹配 中 断 并 复位 TOTC 
TOMR0 = 120/12; // 比 较 值 
TOTCR = 0x03; // 启 动 并 复位 TOTC 
TOTCR = 0x01; 
/* 设 置 定时 器 0 中 断 IRQ* / 
VICIntSelect = 0x00; // 所 有 中 断 通道 设 置 为 IRQ 中 断 
VICVectCnt10 = 0x24; // 定 时 器 0 中 断 设 为 最 高 优先 级 
VICVectahddr0 = (uint32_T)flag; // 设 置 中 断 服务 程序 地 址 向 量 
VICIntEnable = 0x00000010; // 使 能 定时 器 0 中 断 


备 本 ,本 ,有 , 届 要 ,而 画 ] 盏 二 | 本 画 


1/ # Set model inputs here 关 / 


/*# 将 模型 输 和 人 与 硬件 相对 应 * / 
/ < Step the model 关 / 
arm beep step() ; 


1/ *# Get model outputs here #*/ 
/# 将 模型 输出 与 硬件 相对 应 * 7 


int_T main(int T argc，const char T #x argv[]); 


1 
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int_ T main(int T argc，const char T x* argv[ ]) 
人 
/#* Initialize model # / 
arm_beep_initialize(); 


Timer0Init() ; // 调 用 定时 器 0 初始 化 函数 


/* 删除 下 列 代码 * / 


// printf(" Warning: The simulation will run forever.” 
// "Generated ERT main won 't simulate model step behavior.“" 
// "To change this behavior select the 'MRAT-file logging "//option.\n "); 
1// fftlush(C(NULL) ); 
while (rtmGetErrorStatus(arm_ beep M) == (NULL)) { 
/ x# Perform other application tasks here x / 


rt_OneStep(); // 调 用 rt_0OneStep 


/ *#* Disable rt_OneStep() here </ 


/ #x Terminate model x* / 
arm_beep_terminate(); 


return 0 ; 


2. 生成 hex 文件 


单 击 Keil 工具 栏 的 按钮 忆 | ,或 按 Alt 十 F7 组 合 键 , 在 Outpnut 选项 卡 中 ,点 选 Create HEX 
File 单 选 按钮 ,如 图 8. 2. 20 所 示 。 


Jevice | Target 0utput |5stingj] User |] CCt+ | km ]Linker | Debug | Wilities] 


5elect Folderfor Objects Name of Executable- pee 


全 Deale Executable，\beep 
克 Debug mrfomation 厂 Ceaie Batch Fe 
Ceale HEXPFe 
了 Bowse infomalion 

广 Deale Libray- \beep UB 


图 8.2.20 设置 输出 . hex 文件 
再 单 击 工具 栏 按钮 疼 , 重 编译 工程 (图 8. 2. 21) ,窗口 下 部 的 信息 显示 已 成 功 生 成 . hex 文件 。 


构 


.369。 】 
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[天 beee -vson4 


















| 
| 
| 





| 
| | 
[7 划 了 浊 本 sg 
凶 驴 西 总 :use : “ 太 业 | 
| 轴 etmainc ws 
DT ET 
各 Source Group 0es Eap sr nn 
| 2 
电 ff 汐 arm_beepe | 0 并 站 
| 寺 因 artmain<c | 0 0 
ee aa 
| CR 汪 void _Eirq ITRO ZxcepFsicnivoi 
| 司 arm_beep_9ypesh | 036 | 
| 了 wpesh 汪汪 ea 
站 para| 人 zeluipeaJuiecjilm 一 一 | 

| 


Brogram Size: Code=2020 RO-data=32 RYW-data=24 2I-data=1288 
FromELE : Creating hex file.,， 
"peep ,axf"”- 0 Error(s5)，0 Warning(s) . 





生 


图 8.2.21 编译 信息 


8.2.5 虚拟 硬件 测试 


参考 第 8. 1. 2 小 节 的 内 容 , 建 立 蜂 鸣 器 虚拟 硬件 模型 ,并 加 载 先 前 生成 的 . hex 文件 , 单 击 
“仿真 ?按钮 。 可 以 看 到 , 当 输 入 为 0 时 , 蜂 鸣 器 停止 工作 , 当 输 入 为 1 时 ,芯片 输出 脉冲 信和 号， 


驱动 蜂 鸣 器 发 出 声音 ,符合 模型 预期 功能 ,如 图 8. 2. 22 所 示 。 


1 BUZ1 
PI2SCLNCAP0D 六 
PE 3SDADWATD 
PD 4ISCKDICAP01 
P05MISO0MATD1 上 时 BUZER 
PDSNMOSIUCAPD2 六 到 
POJISSELOAMAT20 | 妇 1 1 
PDBIXDINAD1 广 计 Q 
PO SRXD1MAT2 2 上 PNp 


PITORTSTUCAP1 OAD0 3 产 2 
PDTNCTSTVUCAP1 1AD04 一 二 
PO120DSRIAMAT1 QIAD05 
P013DTR1AAT11 

DB86SEL 。 PI14UDOD1SCKHNEINT) 


才 
EC 
关 


PDTICAP12SCU 
PO1BICAP13ISDA1 
P01gMAT1 2MISO1 
PO20MAT1.3W05It 
P01TJSSEL1MAT36 上 
PD22AD0 
18V 3 P0 23AD01 
--- P0 24AD02 
P0 25NADD5 
P0 26ADD7 
P0271TRSTICAP20 
P026rTwSNCAP21 
PD29mTCKICAP22 
PQ 3OTDWMAT33 
P03IT00 





图 8.2. 22 Proteus 原理 图 
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输出 信号 波形 如 图 8. 2. 23 所 示 。 


VSM Oscllloscope 





CHT 国 =。 2 CH2 国 六 风 六 





8.2.23 输出 波形 
8.3 ”交通 灯 控 制 


沿用 3. 7. 2 小 节 建 立 的 交通 灯 模 型 , 稍 作 修改 即 可 在 ARM 处 理 器 上 实现 其 功能 。 将 
Stateflow 模型 重 绘图 8. 3. 1( 略 去 了 LED 灯 与 数码 管 显 示 部 分 ) 。 





图 8.3.1 Simulink 功能 验证 模型 


8.3.1 软件 在 环 测试 


在 生成 代码 前 , 仍 需 要 进行 软件 在 环 测 试 。 
1. 数据 类 型 转换 


在 模块 库 Simulink_>Ports & Subsystems 中 找到 输入 模块 与 输出 模块 ,替换 图 8. 3. 1 中 的 脉 
冲 生 成 器 .常数 .Goto 模块 ,其 余 的 LED 灯 与 数码 管 显示 部 分 也 应 删 去 ,并 将 模型 另存 。 
单 击 模型 窗口 的 按钮 加 ,打开 模型 浏览 器 如 图 8. 3. 2 所 示 , 依 次 设置 Simulink 模型 、 


往 “37I 避 : 


锅 : 基于 模型 的 设计 一 MCU 篇 


Stateflow 状态 图 以 及 状态 图 中 两 个 Embedded MATLAB 函数 的 各 变量 数据 类 型 。 
Simulink 模型 中 的 In 模块 的 数据 类 型 设置 为 uint32,Onut 模块 的 数据 类 型 可 设 为 自动 继 


承 , 也 可 强制 设置 为 uint32 ,如 图 8. 3. 3 所 示 。 


着 本 Simulink Root 
入 8ase 只 ork5patce 
4 观 tra 帮 clight Si 
幕 Model Workspace 


由 Codefortra 帮 idight_5if 
?9 六 dvicefortraffidight_ 5 
5 Configuration 亿 ctivej 


4 史 Chit 看- 一 一 一 一 一 


图 8.3.2 模型 浏览 器 树 状 结构 
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局 ime 
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己 Eliioht 
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[本 R5sec 
[也 Bse 


BlodkWpe OLDpataypestr LOCK5caK 


| 竹 Model Worksp,. 
急 Codefortrg 人 fiK.， 
多 Advice ftortra 人 t.， 
全 5 Configumation .， 


取 Chart 





inhertt auto 
Inherit aut0 
Inherib auto 
Inherit auto 


图 8.3.3 修改 Simujink 端口 数据 类 型 


Stateflow 状态 图 及 所 包含 Embedded MATLAB 函数 time(flag) .remain(x) 的 各 变量 数 


据 类 型 均 设 置 为 uint32 ,如 图 8.3.4. 图 8.3.5.、 图 8.3.6 所 示 。 
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图 8.3.4 修改 Stateflow 参数 数据 类 型 (一 ) 
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图 8.3.5 修改 Stateflow 参数 数据 类 型 (二 ) 
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图 8.3.6 修改 Stateflow 参数 数据 类 型 (三 ) 


打开 Embedded MATLAB 函数 time(flag) ,将 其 中 所 有 常数 的 类 型 也 转换 为 uint32。 


function time(Elag) 


timeout = uint32(0) ; 


Switch fag 


CasSe 1 


nssec = red 


ewSsec = Green 


sec = green x Ulint32(10)} 


casSe 2 


eWSec = red-green; 


sec = (red-green) * Uint32(10) ; 


党 


$ 转化 为 uint32 


# 转化 为 uint32 


第 转化 为 uint32 
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CaSe 3 

eWSec = red; 

nsSec = greeni 

sec = green yx Uint32(10) 4 $ 转化 为 uint32 
Case 4 

nssec = red-green; 

sec = (red-green) * uint32(10); # 转化 为 uint32 

end 


修改 后 的 模型 如 图 8. 3.7 所 示 。 


2. 模型 参数 设置 
打开 模型 参数 对 话 框 , 在 Real-Time Workshop 界面 设置 TLC 文件 为 ert,tlc, 如 图 8. 3. 8 所 示 。 


Target Selection 








System target 侧 e; ert,.tc | Browse..， | 
Language: 7 aa 
7 Description; Real-Time Workshop Embedded Coder 
Chart EWsec 
图 8.3.7 代码 模型 图 8.3.8 设置 TLC 


Real-Time Workshop->Interface 界面 ,取消 色 选 不 必要 的 复 选 框 , 如 图 8. 3. 9 所 示 。 


Software eprvironmert 
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| Variable-Ssze Signals 


Muitiword type defintions: | System get | 


图 8.3.9 Interface 界面 设置 
Real-Time Workshop-~Report 界面 , 色 选 所 有 复 选 框 , 便 于 后 期 检查 及 跟踪 ,如 图 8. 3. 10 所 示 。 


3. 生成 SIL 模块 
在 Real-Time Workshop-~>SIL and PIL Verification 界面 的 Create block 下 拉 列 表 ,选择 


锅 : 基于 模型 的 设计 一 一 MCU 篇 


SIL 选项 ,如 图 8. 3. 11 所 示 。 
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司 Traceable Embedded MATLAB functions 
图 8.3.10 报告 界面 设置 图 8.3.11 SIL 设 置 


单 击 模型 工具 栏 的 按钮 没 ,得 到 代码 生成 报告 (图 8. 3. 12) 与 SIL 模块 (图 8. 3. 13) 。 
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图 8.3.12 代码 生成 报告 图 8.3.13 SILL 模块 


按 第 3.7. 2 节 中 的 Simulink 功能 验证 模型 ,以 SIL 模块 替换 原 有 的 Stateflow 模块 ,重建 
8. 3. 14 所 示 的 验证 模型 ,并 在 各 端口 间 加 入 必要 的 数据 类 型 转换 模块 。 该 模型 的 运行 结果 
与 原 模型 是 一 致 的 。 
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8.3.2 自动 代码 生成 及 编译 


1. 模型 调整 
为 了 适应 ARM 处 理 器 的 输出 形式 ,编写 Embedded MATLAB 函数 combine ,将 8 个 输 


rr co = 和 hi 请 





图 8.3.15 设置 Embedded MATLAB 函数 变量 的 数据 类 型 
代码 如 下 : 


function out = 
combine(nsred,nsyell,nsgreyewred,ewVell,ewgre,nssecyewsec) 

秽 井 em] 

1led = ewgre # Uint32(32) + enwyell * uint32(16) + ewred * ulint32(8) + nsgre xx uint32(4) 十 
nsSYell * uint32(2) + nsred; 

nsl = rem(nssecuint32(10) ) ; 

ns2 = (nssec - nsl) / uint32(10) ; 

ewl = Tem(ewsecyuint32(10)) ; 

ew2 = 《〈《ewsec ~ ewl) / uint32(10) ; 

sec = ew2x#uUint32(4096) + ewl x* Uint32(256) + ns2 x* uint32(16) + nsl; 
out = led+#* uint32(65536) + Secij 


另外 为 了 简化 , 舍 去 原 模 型 中 由 外 部 指定 红 灯 与 绿灯 亮 灯 时 长 的 功能 ,在 Embedded 
MATLAB 函数 time(flag) 中 直接 指定 ,因此 在 函数 中 为 red 与 green 赋值 。 


function 七 ime(flag) 


red = Uint32(15) 4 g% 指定 红 灯 时 长 
green =ulint32(10) ; $ 指定 绿灯 时 长 
timeout = uint32(0) ; 
SWitch 1ag 

case 1 


DSSsec = red ; 


ewSec = greeni 


一: 
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Sec = green#t Ulint32(10) ; 


CaSe 2 
ewSsec = Ted-green; 


Sec = (red-green) # Uint32(10); 
case 3 


ewsec = Ted; 
nssec = Green; 


Sec = green#r Ulint32(10); 


Case 4 
nssec = red-green; 


sec =〈(red-green) #* Uint32(10); 
end 


调整 后 的 代码 生成 模型 如 图 8. 3. 16 所 示 。 


Unt32 






Combine 


图 8.3.16 代码 模型 
2， 指定 硬件 


打开 模型 参数 对 话 框 , 在 Hardware Implimentation 界面 ,设置 器 件 类 型 为 ARM7 ,如 图 8. 3. 17 
所 示 。 
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图 8.3.17 选择 芯片 


将 Real-Time Workshop-~>SIL and PIL Verification 界面 的 Create block 下 拉 列 表 ,选择 
none 选项 ,如 图 8. 3. 18 所 示 。 
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单 击 模型 工具 栏 的 按钮 山 ,生成 代码 ,报告 如 图 8. 3. 19 所 示 。 
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图 8.3.18 SIL 设置 图 8.3. 19 代码 生成 报告 


3. 建立 Keil 工程 


打开 Keil uVision4 ,建立 基于 LPC2103 的 工程 ,如 图 8. 3. 20 所 示 。 将 图 8. 3. 19 所 示 的 6 个 
文件 与 Keil 工程 保存 在 同一 目录 下 ,这样 在 编译 时 ,编译 器 会 自动 找到 所 需要 的 头 文件 ,无 需 手 
工 添 加 。 
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8.3.20 Keil 工程 


蝇 : 基于 模型 的 设计 一 一 MCU 篇 


单 击 Keil 工具 栏 的 按钮 | 胎 , 或 按 Alt 十 F7 组 合 键 , 在 Outpnut 选项 卡 , 勾 选 Create HEX 
File 复 选 框 , 如 图 8. 3. 21 所 示 。 
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8.3.21 设置 输出 HEX 文件 


4. 代码 修改 
刚刚 生成 的 代码 实现 了 Stateflow 算法 ,未 包含 脉冲 发 生 器 模块 以 及 硬件 接口 ,因此 还 需 
要 使 用 定时 器 中 断 实现 脉冲 发 生 器 模块 ,并 将 算法 的 输出 与 硬件 端口 相连 接 , 修 改 的 代码 以 斜 
体 字 表示 如 下 : 


## incIude <stdio. 户 > [1 网 克 该 头 广 伴 
井 include "1light_count keil.h" 
井 incluade“rtwtypes."” 


# include <LPC2103. 万 > AV 新 赚 该 头 文 伴 

void _ irqgt0(void) A/ 由 断奶 务 枉 序 

{ moTC = 0 AA 计 肝 属 游 替 
TOIR = 0x01; [1 诗 克 内 上 断 页 起 
IOCLR = 0x003EFEFFF; /1 医 出 小 条 
trafficlight_arm_ U.tine = 一 trafficlight _ara_ ltimes 
VICVectaaar = 0x00; AMV 内 上 断 向 盘 红 克 


} 


Volid rt_OneStep(volid) ; 
void rt_OneStep(void) 
1/ Step the model 
trafficlight_arm_step(); 
// Get model outputs here 
IOSET = trafficIight arm_ YY. ledj [A 将 葵 旧 与 侨 原 柄 件 连 成 昔 巷 


:378 。 … -和 盯 
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int 了 T malin(int T argc，const char T * argv[ ]); 


int_T main(int_ T argc，const char T * argv[]) 


{ 


} 


/Initialize model 
trafficlight_arm_initialize(); 
PINSELO = 0x00000000; 
PINSEPI = 0x00000000 ; 


IODIR = 0x003FFEFF; [1 情趣 7D 为 葵 坊 
trafficJlight arm U. tine = 0 鹿 发 信 导 砷 努 为 O0 

// 定时 器 初始 化 

TDTCR = 0x021; [V 爷 诸 状 0 复 龙 

TDPR = 99; AV 分 频 丛 

TOMCR = 0x03; [A 匹 醒 后 复 花 生 , 江 产 竺 内 断 
TOMR0O = 12500; AV 优 肝 匹配 管 与 外 频 得 ,有 房 户 应 检 瘤 实 奈 硬 伴 矶 过 
TOIR = 0OxFF; [V 装 队 只 断 碌 坡 

TOTCR = 0x01; /1 房 动 企 计 玫 0 

AA 只 断 向 叔 夫 扫 化 

VICIntSelect = VICIntSelect& (一 (1 <<4))3; [1A 人 定时 玫 0 耸 配 为 Zao 内 上 断 
VICVectCnt10 = 0x20 | 4; [1V 钨 肝 玫 0 欠 醒 为 向 盘 ZU2 通过 0 
VTCVectaadr0 = (uint32_T)t0i [1 欠 配 办 上 断 胶 务 枉 序 地 机 
VICIntEnable = 1 <<4; [1 定时 天 0 办 断 允 通 

[1/ 删 克 以 下 代码 


/printf(” Jrning: The simulation will run forever.” 

//"” Generated ERT main won 't sinulate model step behavior.” 
//" To change this behavior seJect the "MahT-file 

/1/Iogging "option.\D ")i 

/1 ffIush(CNOLL))3 

whiIe (rtmGetErrorStatus (trafficlight_arm_ NMH) ==《NUIDL )) 
{ Tt_ OneStep(); 

} 


代码 修改 完成 后 单 击 工具 栏 按 钮 亦 , 编 译 工 程 , 如 图 8. 3. 22 所 示 , 窗 口 下 部 的 信息 显示 
已 成 功 生 成 . hex 文件 。 


8.3.3 虚拟 硬件 测试 


仿造 3. 7. 2 小 节 的 Simulink 模型 ,根据 本 章 第 5. 1 节 的 介绍 ,建立 proteus 交通 灯 模 型 ， 
并 加 载 先 前 生成 的 HEX 文件 。 单 击 “ 仿 真 ? 按 钮 ,模型 即 按 预 设 的 时 间 亮 灯 , 实 现 了 Simulink 
模型 所 设计 的 功能 ,如 图 8. 3. 23 一 图 8. 3. 26 所 示 。 
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图 8.3.22 编译 Keil 工程 
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图 8.3.26 南北 向 缓行 
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$. 4 步 进 电动 机 控制 


AMKrywmer2PERE SA 和 3 ev 人 色 1 SheFGETCaRisDCYCEN- 一 MinrVERN 和 ETegeP2Tyy vLETOg 加 yc 区 下放 07 人 7 和 信人 二 os 


8.4.1 步 进 电动 机 原理 简介 


步 进 电动 机 是 机 电 一 体 化 产品 的 典型 代表 ,在 精密 仪器 制造 ,数控 机 床 等 工业 控制 系统 中 
有 着 广泛 应 用 。 

步 进 电 动机 不 同 于 普通 直流 电动 机 , 它 不 是 连续 转动 的 ,而 是 每 当 驱 动 器 接收 到 一 个 脉冲 
信号 , 它 就 驱动 步 进 电动 机 按 设 定 的 方向 转动 一 个 固定 的 角度 , 故 称 为 步 进 电动 机 。 用 户 可 以 
通过 控制 脉冲 个 数 来 控制 角 位 移 量 , 从 而 实现 精确 定位 ;通过 控制 脉冲 频率 来 控制 电动 机 转动 
的 速度 和 加 速度 ,从 而 实现 调 速 。 

步 进 电动 机 按 相 数 可 分 为 单 相 . 双 相 及 多 相 。Proteus 中 的 步 进 电动 机 是 以 四 相 步 进 电 
动机 为 模型 建立 的 ,下 面 针 对 该 电动 机 作 原 理 说 明 。 

该 电动 机 的 转子 为 永 磁体 ,定子 为 电磁 线圈 。 当 定子 绕 阻 中 的 某 一 相 有 电流 流 过 时 , 绕 阻 
会 产生 磁场 ,该 磁场 会 使 转子 旋转 一 个 角度 ,使 转子 的 磁场 方向 与 其 保持 一 致 。 然 后 ,下 一 个 
绕 阻 通电 , 绕 阻 磁场 随 之 转 过 一 个 角度 ,转子 再 次 旋转 至 绕 阻 磁场 方向 。 这 样 , 每 输入 一 个 脉 
冲 , 电 动机 就 会 转动 一 个 角度 ,连续 不 断 的 脉冲 输入 就 可 以 驱动 电动 机 持续 旋转 了 。 

在 实际 应 用 中 ,可 以 采取 多 种 不 同 的 励磁 方式 。 例 如 ,首先 给 A 绕 阻 通电 ,转子 转动 到 A 
绕 阻 的 磁场 方向 ;然后 同时 给 A,B 两 个 绕 阻 通电 , 则 同时 在 A,B 两 个 方向 上 产生 磁场 ,转子 
会 转动 到 A,B 之 间 的 平衡 位 置 ; 接 下 来 个 A 绕 阻 断 电 ,B 继续 保持 导 通 状态 ,这 样 转子 转动 到 
B 绕 阻 的 磁场 方向 ;按照 类 似 的 顺序 , 导 通 B,C 一 C 一 CD 一 D 一 DA 一 A, 电 动机 同样 可 以 持续 
旋转 ,这 种 励磁 方式 可 以 减 小 电动 机 的 步 进 角 ,有 效 提 高 控制 精度 。 如 图 8. 4. 1 一 图 8. 4. 3 
所 示 。 





图 8.4.1 A 相 导 通 图 8.4.2 AB 相 导 通 图 8.4.3 B 相 导 通 


8.4.2 步 进 电动 机 控制 模型 


本 例 用 四 相 八 拍 的 方式 驱动 四 相 步 进 电动 机 。 设 4 个 绕 阻 分 别 为 A.B、`C、D, 则 其 通电 顺序 
为 A-AB-B-BC-C-CD-D-DA。 根 据 第 3 章 的 介绍 ,容易 建立 驱动 步 进 电动 机 的 状态 图 (图 8. 4. 4) 。 


本 .382。 0 
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图 8.4.4 步 进 电动 机 驱动 模型 


其 中 数据 io0set \io0clr 以 十 六 进 制 形式 表示 通电 的 绕 阻 ;pinselo ,io0dir 为 状态 设置 ; 事 
件 flag 表示 绕 阻 通 . 断 电 转 换 标 志 , 如 图 8.4. 5 所 示 。 








| Name Scope Port Resolve Signal Datafype 
乡 flag Input 1 

因 pinselo output 1 同 doubie 
轩 ioodr output 2 ”加 double 
| 吴 iooset output 3 ” 辐 double 
国 io0cjr output 4 加 double 


图 8.4.5 步 进 电动 机 驱动 模型 数据 列表 


8.4.3 步 进 电动 机 的 功能 验证 模型 


完成 步 进 电动 机 驱动 模型 之 后 ,在 Simulink 模块 库 中 找到 图 8. 4.6 .图 8.4.7 所 示 模 块 ， 
并 按 图 8. 4. 8 所 示 连 接 。 


Wiodel Yerlitlcatlon 
一 ports & Subsystems 和 -人 lodelL-Wide Utilities 
SignalAttributes 


| | Ports 和 Subsystems 
aa ， 习 员 | -Signal Attributes | 
革 一 | -Si 名 al Routing | 

| User-Defned Functions | | 





| 直 -Additional Math & Discrete | Sorces 
上 电 Aerospace bbase i”User-Defined 了 unctions 
图 8.4.6 脉冲 发 生 器 模块 图 8.4.7 示波器 模块 
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Pulse 
Generatorf 


Char 


图 8.4.8 功能 验证 模型 


选择 模型 主 窗 口 的 菜单 项 Simulation 一 Configuration Parameters. . . ,打开 模型 参数 对 话 
框 , 在 Solver options 面板 中 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 8. 4. 9 
所 示 。 


Solver options 
Type: | Fixed-step  Y Soker: discrete fno continuous states) v 


Fixe 中 Step Size (fundamental sample time) 0.01 


图 8.4.9 求解 器 设置 


Pulse Generator 模块 产生 脉冲 ,使 flag 不 断 变化 。 运 行 模型 ,可 以 看 到 io0set 端口 的 输 
出 信号 在 一 个 周期 内 有 8 种 状态 ,如 图 8. 4. 10 所 示 。 


四 Scope2 








8.4.10 仿真 结果 


3 殴 
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Io0set 值 为 1 时 对 应 于 二 进 制 数 0001, 即 A 绕 阻 导 通 ; 值 为 3 时 对 应 于 二 进 制 数 0011, 即 
A,B 绕 阻 导 通 ; 值 为 2 时 对 应 于 二 进 制 数 0010, 即 B 绕 阻 导 通 ; 值 为 6 时 对 应 于 二 进 制 数 
0110, 即 B,C 绕 阻 导 通 ; 值 为 4 时 对 应 于 二 进 制 数 0100, 即 C 绕 阻 导 通 ; 值 为 12 时 对 应 于 二 进 
制 数 1100, 即 C,D 绕 阻 导 通 ; 值 为 8 时 对 应 于 二 进 制 数 1000, 即 D 绕 阻 导 通 ; 值 为 1 时 对 应 于 
二 进 制 数 1001, 即 D、A 绕 阻 导 通 。 


8.4.4 软件 在 环 测 试 


在 模块 库 Simulink / Ports 扩 Subsystems 中 找到 输入 模块 ,替换 图 8. 4. 8 中 的 脉冲 信和 号 
源 与 常量 输出 ,并 将 这 些 端口 的 数据 类 型 修改 为 uint32, 如 图 8. 4. 11 所 示 。 





图 8.4.11 代码 模型 


另外 还 需要 确保 Stateflow 模型 中 数据 的 类 型 也 应 为 uint32, 如 图 8. 4. 12、 图 8. 4. 13 
所 示 。 


Name BlockType OutDataTypeSr DutMin OutMax LocksScale DataType 

| 稚 Model Worksp 

筷 Code for arm_ 

| 多 Adviceforamm. 

乱 Configuration 

允 chart 

已 Outi uint32 村 0 国 

已 ou ; uint32 日 [ ] 

天 out uint32 导 恒 

已 out4 uint32 和 日 时 
昌 





| 已 ml uint32 


图 8.4.12 修改 模型 端口 数据 类 型 


Name Scope Port Resolve Signal Datafype Srze Initialvalue Complledfype Compllek 
四 Init 
乡 flag Input 1 
团 ioodir out. 2 加 
园 iooset ou 3 目 
图 ioockr out. 4 同 
关 所 疝 一 一 T 有 - 





图 8.4.13 修改 模型 内 部 数据 类 型 
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在 Report 界面 中 , 勾 选 所 有 复 选 框 , 便 于 后 期 检查 及 跟踪 ,如 图 8.4.14 所 示 。 


y Create code generation report v Launch report automatically 


Navigation 


Y Code-to-maodel 


Traceability Report Contents 
v Eliminated /virtual blocks 
Y Traceable Simulink blocks 
v Traceable Stateflow objects 


y Traceable Embedded MATLAB 和 和 ncions 


8.4.14 报告 设置 界面 


在 Real-Time Workshop 界面 中 ,设置 TLC 文件 为 ert. tlc, 如 图 8.4.15 所 示 。 
打开 模型 的 参数 设置 对 话 框 , 在 Real-Time Workshop 一 SIL and PIL Verification 界面 ， 
勾 选 Create SIL block 复 选 框 ,如 图 8.4. 16 所 示 。 


Software-in-the-loop (SRL) and processor-in-the-loop (PIL) verification 


Enable portable word SizeS 
Target selection ecenerate verification blocks 
ee 司 Create SB block 
System target 侧 e; ert.tlc BrowsSe,.. 
一 -一 一 一 一 一 一 一 一 Code coverage 
Language: | | 
Fe Code coverage tool: 人 one * Configure Covarage 

Description': Real-Time Workshop Embedded Coder 


图 8.4.15 设置 TIC 图 8.4.16 SIL 设置 


单 击 模型 工具 栏 的 按钮 洗 , 生 成 SIL 模块 ,如 图 8. 4. 17 所 示 。 





RTW $-Function 


图 8.4.17 SIL 模块 


如 图 8. 4. 8 所 示 ， 以 SIL 模块 替换 Stateflow 模块 ,重建 图 8. 4. 18 所 示 的 验证 模型 ,由 于 
SIL 模块 是 根据 定点 模型 建立 的 ,因此 各 端口 间 加 入 了 数据 类 型 转换 模块 。 
该 模型 的 运行 结果 与 图 8. 4. 10 所 示 的 结果 是 一 致 的 ,如 图 8. 4. 19 所 示 。 


， “386。 
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Pulse 
Generator 


Data Type Conyersion 


RTW S-Function 


图 8.4.18 SIL 测试 模型 








mm。 旭 如 
园 Scops | 
急 自 胃 有 用 属国 图 日 高 拟 。 





图 8.4.19 仿真 结果 


8.4.5 自动 代码 生成 


打开 模型 的 参数 设置 对 话 框 ,在 Hardware Jmplimentation 界面 中 ,设置 器 件 类 型 为 
ARM 7 ,如 图 8. 4. 20 所 示 。 


Embedded hardware 【Simulation and code generatiom) 
Devlce yendor; aFRN Compat1lb1le 


Device type: AR 了 


图 8.4.20 选择 芯片 
单 击 模型 工具 栏 的 沼 按 钮 ,生成 代码 的 报告 如 图 8. 4. 21 所 示 。 


300 
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ed | | ile: VENTLUAB TILESNarm stepper 


matorVarm 5t0DDPCF_ JotOE_ erT ftwAert Rig.C 


Contents 
Sammary -证 作 汪 
4 
RDRSDAE 7 刘 
和 jntetace RacC 4 si Jr Pd yepeTafed PP KEN 80 汪 语 20PFEE 220F | 
了 | 
Ts 上 y ReDgI | 
TO 半 0 大 
7 Poem rhap 二 ia ref 9 贡 -Fanr 人 /1 ;时 
Generated Flles 六 二 
[-) wei 短 e 了 :FE Cr 再 2J 信 
-一 陀 六 TCF red imripted 2n :Sn 7 部 车 隐 寺中 和 
吐 - 了 3 ， 
1-] Model es 立正 TVe1 59Jasti5 ct 
订 =Eaieddejd iargosryr 57Jeofipc7 JETOCWpPofibja ARE 7 
了 oaSC TO 一 王 es guneratipo dpyectiyw5 Lopeczried 
an 区 22Qer_IDStnf 上 了 路 站 陶 恒 全 1 
下 RDDar_ mdO DIE 国 下 “ 
mL 让 8DDer 中 疏 双 -RES 村 本 《下 则 了 5 LS Di er TEL 
CH Utahy files (1) 22ote 43tegPer niror'h 外 
到 wu 和 “防暑 ?pesikh 癌 硬 防 5 PPes 十 
世 asreeitfinr 坟 De Tt 56edi-fSe Cipir Ar7 9867UPE 5272024 Teaf223 


可 r 和 
1 WU MTP w1A 人 FA 06 3 1 de kreter ME 
ray 二 e aa 26ir 在 目 1n9 te enzrated :de En 58S1U7 

FF Jieritpt WU 站 ME Point entert sdfEh9T 8 tif ec 有 5 
2 Wap fpap In 让 catfs 轴 PFP 1 38psly fr Rare ielt3me 人 EEC 
?9 He geardfad eede Sep funcfia Derrun beihewraor chould he torw 25 
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也 TCRAIE-NA Bodel an ref 206 52 


要 Re 






和 





图 8.4.21 代码 生成 报告 


1， 建 立 Keil 工程 
打开 Keil uVision4 ,芯片 选择 LPC2103 ,建立 工程 ,并 加 和 人 生成 的 代码 ,如 图 8. 4. 22 所 示 。 


rp 


2 二 ro 本 人 下 了 了 


= 河 Target1 
所 过 Source Group 工 | | ELe sz EEC 
国 Starups | 
习 . 国 am_stepper_motor5 
习 - 因 etmeam<c 1 ”Model varsl25 


ReslI~Tie Yopxksbop ccce eeraced fo Sciin Di 


司 amm_stepper_metorh To9hog 
f ， k Reax-TIWR WOEKSRcD 乓 
加 amm_yteppermotor_private， 


、“ 


国 arm_steppermcter_tyPe5h wm /ESs9 sDd5G5 20ds 剖 


VTSAO 


Taxoes stiecctcni 





8. 4.22 Keil 工程 
代码 并 不 能 直接 使 用 ,还 需 在 ert_main. c 中 作 如 下 修改 ; 


人 


// #include < stdio.h> /x 在 后 面 的 代码 中 删除 了 函数 printf/fflush, 因 此 不 需要 stdio.h * / 
井 include ”arm_stepper_motor.h" /# Model's header file x / 

# include "rtwtypes.h"” / * MathWorks types #/ 

# include < LPC21XX.H> /# LPC21XX 头 文件 * / 


// 手动 添加 Timer0 的 终端 服务 程序 


的 


9 
， 
aaa4maaarwenairenmireareses 一 足 
4 
、 
， 
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void _ irqg flagCvold) // 中 断 服务 程序 


人 
if(arm_ stepper _ motor _U. Inl == 0) 


arm_stepper_motor_U. Inl = 1; //flag 置 1 

else arm_ stepper_motor_U. Inl1 = 0; /1/flag 置 0 

TOIR = 0x01; /7 清除 中 断 标志 
VICVectaddr = 0x00; // 通 知 VIC 中 断 处 理 结束 


} 
// 手动 添加 Tinmer0 的 初始 化 代码 


void Timer0Init(void) // 初 始 化 定时 器 0 

{ 
TOPR = 99; // 定 时 器 分 频 系 数 设置 为 100 
TOMCR = 0x03; // 匹 配 通道 0 匹配 中 断 并 复位 TOTC 
TOMRO = 2500; // 匹 配 通道 0 的 比较 值 
TOTCR = 0x03; // 启 动 并 复位 TOTC 
TOTCR = 0x01; 
// 设 置 定时 器 0 中 断 IRQ 
VICIntSelect = 0x00; // 所 有 中 断 通 道 设置 为 IRQ 中 断 
VICVectCnt10 = 0x24; // 定 时 器 0 中 断 设 为 最 高 优先 级 
VICVectaddr0 = (uint32_T)flag; // 设 置 中 断 服务 程序 地 址 向 基 
VICIntEnable = 0x00000010; // 使 能 定时 器 0 中 断 


本 


/# Set model inputs here x / 
/# 将 模型 输入 与 硬件 相对 应 * / 
/x# Step the model x / 


aTm_Stepper_motor_step()， 


/ # Get model outputs here * / 
/* 将 模型 输出 与 硬件 相对 应 * / 
int_ T main(int_T argc，const char JT * argv[ ]); 
int_ T main(int_ T argc，const char T * argv[ ]) 
{ 

1 # Initialize mocel 关 / 


arm_Sstepper_motor_initialize(); 


Timer0Init() ; // 调用 定时 器 0 的 初始 化 函数 


// 删 去 函数 printf 和 fflush 
// printf(" Warning: The simulation will run forever. 
/1/ "Generated ERT main won 't simulate model step behavior， 
77 "To change this behavior select the 'MRT-file logging'" option.N\n "); 
// fflushCCNULL) ) ; 
”while (rtmGetErrorStatus(arm_stepper_motor M) ==《〈NULL)) { 
/ * Perform other application tasks here #/ 
rt_OneStep(); // 调 用 rt_OneStep() 天 数 
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/<* Disable rt_OneStep() here #/ 


/ # Terminate model * / 
arm_stepper_motor_terminate( ) ; 


return 0; 


2. 生成 HEX 文件 


单 击 Keil 工具 栏 的 按钮 灰 , 或 按 Alt 十 F7 组 合 键 , 在 Output 选项 卡 中 , 勾 选 上 Create 
HEX File 复 选 框 , 如 图 8. 4. 23 所 示 。 


Bevice | Target 0atput | -sting| User | ccr | km Linker | Debug Wilities| 


Selec Folderfor Obects | Name of Euecuabie pem 


他 Ceale Eueculable，\beep 
FF Duan 厂 Ceaie Bzch Re i 
Ceate HEXPFie 
Browse iomahon 

广 Ceae LUbray beep LIB 


图 8.4.23 设置 输出 HEX 文件 


再 单 击 工具 栏 按钮 山 , 重 编译 工程 ,如 图 8. 4. 24 所 示 ,窗口 下 部 的 信息 显示 已 成 功 生成 
HEX 文件 。 





外 anesaarreern 剖 - RRoh 
| E 现 Baed Fa Deeog Perphen Joog SC5 ypndon bep 


7 下 玫 可 药 5 习 dd 
下 玉 本 Tai "” 让 
习 etmaihc 
村 河 TargetI 1 00 本 | 
1 = Source Group 1 | 002 Te 822 
| 过 Startup35 | - ， ES IE | 
| W 沁 arm_5epPper_motorc 005 
| 刷 - 汪 ermaln< 006 = 
| 本 arm_stepper mctorh 007 四 Te YI 
| 失 008 RS- 了 3TR 和 CT Re 了 ear 吉 
各 司 arm_siepper metor_prvate 上 让 ee 
| 辐 wm stepper motorypesh | 00| ，5E- soozee code Tenetacec 


| 司 wypesh | 01 


上 TO 





aiang… “ 
|iProgram Size: Code=2280 RO-data=32 RW-data=24 2I-data=1288 上 
|FrzomELF; creating hex file， 让 

站 





| am StepPer motor .axft”- 0 Erzzoz(s) ， 0 Warning(s)l ， 
| 
下 





图 8.4.24 编译 信息 


”1 中 
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8.4.6 虚拟 硬件 测试 


建立 图 8. 4. 25 所 示 的 驱动 步 进 电动 机 模型 ,ULN2003A 芯片 用 以 驱动 步 进 电动 机 。 添 


加 示波器 来 监视 ULN2003A 输出 的 波形 是 否 符 合 设计 逻辑 。 







癌 .11KTSTKCaAP11MD04 
PO42DSR1AAT10AD0S 
PO.13DTR1AAT1.1 


图 8.4.25 Proteus 原理 图 
打开 电动 机 模块 ,将 其 电压 设置 为 5V, 步 进 角 设 为 30", 如 图 8. 4. 26 所 示 。 


(人 引 汪 ROSE 
RS 


介 Exclude hrom Smuaion Allsch herschy mod 如 
| Exckude fom PCB Laycu 

有 E 居 训 properies 上 let | 
is | 


图 8.4.26 设置 电动 机 参数 





.39 ; 





由 ULN2003A 模块 输出 的 电 平时 序 如 图 8. 4. 28 所 示 。 


基于 模型 的 设计 一 MCU 篇 


一- 一 一 -一 <- 一 一 -~- -一 一 一 -一 -一 -一 一 一 一 -一 一 一 





POOTXDOMAT31 
PDTWRXDOMAT32 
PO 2/SCLOCAP0 
PO3/SDADMAT00 
PO4SCKMCAP0: 
0 5/MISOOMATO 1 
PO SIMOSIOICAP0 .2 
PO TISSELOMAT20 
POSTXDWMAT21 
PO SRXDTMAT2 2 
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8.5 无 刷 电动 机 的 控制 


8.5.1 无 刷 电动 机 原理 简介 


目前 ,电动 机 可 以 分 为 两 类 :直流 电动 机 和 交流 电动 机 。 直 流 电动 机 是 最 早出 现 的 电动 
机 ,也 是 最 早 实现 调 速 的 电动 机 ,具有 良好 的 线性 调 速 特性 ,简单 的 控制 性 能 ,高 质 高 效 平滑 运 
转 的 特性 ,不 过 由 于 电 刷 和 换 向 器 的 存在 阻碍 了 它 的 发 展 ,逐渐 被 交流 电动 机 所 取代 。 

直流 无 刷 电动 机 用 装 有 永 磁 体 的 转子 取代 有 刷 电 动机 的 定子 磁极 ,用 逆 变 器 和 转子 位 置 
传感器 组 成 的 电子 换 向 器 取代 有 刷 直 流 电动 机 的 机 械 换 相 器 和 电 刷 。 这 样 ,有 效 地 避免 了 因 
电 刷 引起 的 火花 和 噪声 等 问题 ,机械 特 性 和 调节 特性 得 到 了 提高 , 调 速 范围 宽 , 寿 命 长 .噪声 
小 .不 存在 换 相 火花 。 此 外 ,还 具有 交流 电动 机 结构 简单 .运行 可 靠 .维护 方便 的 特点 。 可 用 于 
一 般 直流 电动 机 无 法 应 用 的 易 燃 、 易 爆 环境 。 

直流 无 刷 电 动机 的 工作 离 不 开 电 子 开 
关 电 路 ,因此 由 电动 机 本 体 、 转 子 位 置 传 感 
器 和 电子 开关 电路 三 部 分 组 成 了 直流 无 刷 
电动 机 的 控制 系统 ,其 原理 框图 如 图 8. 5.1 
所 示 ,直流 电源 通过 开关 电路 向 电动 机 定 图 8.5.1 控制 无 刷 电动 机 原理 图 
子 绕组 供电 ,位 置 传感器 随时 检测 到 转子 
所 处 的 位 置 , 并 根据 位 置信 号 来 控制 开关 管 的 导 通 和 截止 ,从 而 自动 地 控制 了 哪些 绕组 通电 ， 
哪些 绕组 断 电 ,实现 了 电子 换 相 。 

下 面 以 一 个 三 相 绕组 的 无 刷 电动 机 为 例 简要 介绍 其 工作 原理 。 图 8. 5. 2 所 示 电 路 为 三 相 
全 桥 式 驱动 电路 ,本 例 对 其 采用 二 相通 电 的 方式 驱动 , 即 有 两 个 绕 阻 同时 通电 。 图 中 包含 有 6 
个 功率 管 ,二 极 管 组 成 的 三 相 闭 变 电路 ,Ha、Hb Hec 为 堆 尔 元 件 反馈 的 转子 位 置信 号 。 控 制 
电路 会 根据 位 置信 号 决定 6 路 PWM 信和 号 的 通 断 ,进而 使 功率 管 导 通 或 关 断 使 绕 阻 按 一 定 顺 
序 导 通 ,驱动 电动 机 连续 旋转 。 








图 8.5$.2 驱动 电路 原理 图 





当 采 用 二 相 导 通 方式 驱动 电动 机 时 ,功率 管 的 导 通 或 关 断 情况 每 经 过 1/6 周期 即 60 。 在 
直流 无 刷 电 动机 的 内 部 戏 有 3 个 起 尔 位 置 传感器 ,它们 在 空间 上 相差 120 “。 由 于 电动 机 的 转 
子 是 永 磁 体 , 当 它 在 转动 的 时 候 , 其 磁场 将 发 生变 化 形成 旋转 磁场 ,每 个 直 尔 传感器 都 会 产生 
180 脉 宽 的 输出 信号 。 

假设 当前 功率 管 V1,V6 导 通 , 则 电流 从 A 相 流 和 电动 机 ,从 C 相 流出 电动 机 ,由 电流 经 
绕 阻 产生 的 磁场 方向 为 A,-C, 如 图 8.5.3 所 示 。 由 A 和 -C 的 合 磁场 长 生 的 转 矩 使 转子 转动 
到 AC 位 置 。 转 子 的 转动 使 徐 尔 传感器 的 输出 发 生变 化 ,控制 电路 会 据 此 调整 功率 管 的 导 通 
情况 ,将 V6 关 断 ,V5 导 通 。 这 时 ,电流 从 A 相 流 入 电动 机 ,从 B 相 流出 电动 机 ,有 电流 经 绕 
阻 产 生 的 磁场 方向 为 A,-B, 如 图 8.5.4 所 示 。 由 A 和 -B 的 合 磁场 长 生 的 转 抢 使 转子 转动 到 
AB 位 置 。 同 样 地 , 霍 尔 器 件 又 会 输出 一 个 不 同 的 值 ,控制 电 路 做 出 相应 的 处 理 , 完 成 一 个 完 
整 的 换 相 周期 。 





图 8.5.3 AC 相 导 通 图 8.5.4 AB 相 导 通 


8.S.2 IASKING IDE FOR ARM 


TASKING VXr-toolset for ARM 是 Altum 公司 推出 的 一 款 ARM 编译 器 ,能 够 完成 从 Edit、 
Make 到 Debug 等 一 整套 开发 工序 ,并 针对 ARM 芯片 做 过 优化 设计 ,可 有 效 提高 其 效率 。 

如 果 用 户 没 有 这 蒜 软 件 , 则 可 在 http://www. tasking. com/products/trials-and-demos， 
shtml, 页 面 中 下 载 其 试用 版 本 , 单 击 ARM VX-Toolset Trial Version 填 人 必要 注册 信息 后 即 
可 下 载 , 如 图 8. 5. 5 所 示 。 








TASKING 


图 8.5.5S TASKING 网 页 
,394 
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TASKING VX-toolset for ARM 编译 环境 针对 ARM 芯片 进行 了 优化 ,效率 较 高 ,可 以 独 
立 使 用 ,但 由 于 此 试用 版 本 与 MATLAB 所 支持 的 TASKING 版 本 号 并 不 相同 ,因此 若 要 和 
MATLAB 联合 工作 ,用 于 自动 代码 生成 ,还 需要 更 换 部 分 文件 ,用 户 可 登录 北京 航空 航天 大 
学 出 版 社 “ 下 载 中 心 " 下 载 并 替换 原文 件 。 

注意 :此 方法 仅 用 于 学 习 本 书 之 用 ,如 果 读 者 想 用 于 项 目 开 发 ,还 请 安装 MathWorks 公 
司 指定 的 TASKING EDE 正版 软件 。 


8.S$.3 无 刷 电动 机 控制 模型 


根据 上 述 原理 简介 可 知 ,无 刷 电 动机 由 一 组 PWM 信和 号 驱动 。PWM 信号 按 霍 尔 元 件 传 
送 的 位 置信 号 决定 其 通 断 状态 ,以 驱动 电动 机 连续 旋转 ;而 PWM 信和 号 占 空 比 可 用 于 调节 电动 
机 转速 。 在 Init 状态 中 ,为 模型 设置 PWM1 一 PWM6 六 路 PWM 信号 ,并 以 按 key 键 的 值 控 
制 电 动机 的 开关 ,由 此 可 作 无 刷 电动 机 的 状态 图 ,如 图 8. 5.6 一 图 8. 5. 8 所 示 。 


Init 

en'io0dir=0: 
pinsel0=0x000A800A， 
pinsel1=0x00400800; 


fkey==1 





图 8.5.6 无 刷 电动 机 控制 模型 


MotorOf 
pwmmr0=1024.pwmmr1=Upwmmr2=Upwmmr3=0 
pwmmr4=0Upwmmro=Upwmmr6=UpWmler=Ox 辣 ; 





图 8.5.7 MotorOff 子 状态 


2959 


辆 : 基于 模型 的 设计 一 MCU 篇 


1 D 
pwmmr0=1024;pwmmr1=0;pwmmr2=0:pPwmmr3=speed;|-， 


\ pwrnmr4=speedpwmmr5=0pwmmr6=0:pwmier=0x7F; 
fsensor==5] 


pwmmr0=1024;pwmmr1=speedpwmmr2=0:pwmmr3=0;|- 一 
\pwmmr4=0.pwmmr5=0;:pwmrmr6=speed;pwmler=0y7F: 
IE 


[sensor==2 


pwmmr0=1024;pwmmr1=0;pwmmr2=speed;pwmmr3=0;|: 
pwmmr4=speedpwmmr5=0:pwmmr6=0:pwmiler=OX7F; 


| - [sensor==3] 





一 9 
Sensor==4] B ] 


re pwmmr0=10224:pwmmr1=speedpwmmr2=0:pwmmr3=0: 
pwmmr4=0:pwmmr5=speedpwmmr6=0:pwmler=0x7F; 
F [sensor==1] 
pwmmr0=1024;pPwmmr1=0;Ppwmmr2=speedpwmmr3=0 ， 


JPwmmr4=0; mr5=0:pwmmr6=speed:pwmler=0x7F; / 


pwmmr0=1024;pwmmr1=0:pwmmr2=0pwmmr3=speed; 
pwmmr4=0Pwmmr5=speedpwmmr6=0;pwmier=0x7F; 





图 8.5.8 MotorOn 子 状态 


在 MotorOff 子 状 态 中 ,将 六 路 PWM 信和 号 的 占 空 比 调 至 0, 以 达到 关闭 电动 机 的 作用 。 

在 MotorOn 子 状态 中 ,模型 接收 赴 尔 元 件 传 送 回 的 电动 机 转子 位 置信 号 ,并 以 此 判断 
PWM 信和 号 的 通 断 。 

其 中 pinsel0 ,pinsell ,io0dir 为 芯片 设置 位 ,pwmmr0 一 pwmmr6 联合 控制 PWM 输出 ， 
sensor 表示 霍 尔 器 件 的 值 ,key 控制 电动 机 是 否 工 作 , 变 量 speed 接收 外 部 的 控制 信号 ,调节 
PWM 占 空 比 , 实 现 电 动机 调 速 , 如 图 8. 5. 9 所 示 。 


Name S$cope Port Resolve Signal Datafype Size 


辐 pinself Output 1 double 
国 pinsel Output 2 double 
[ 朵 ioodir Output 3 double 
四 ] pwmmrg Cutput 4 double 
sensor Input 1 double 
回忆 Input 2 double 
[ 辐 spesd Input 3 double 
图 pwmma Output 5 double 
[ 国 pwmmrz Output 6 double 
加 pwmmr3 Output ?7 double 
鸭 pwmmra Output 8 double 
[ 国 pwmmr5 Output $ double 
[加 pwmmrg Output 功 doubke 
[pwmler cutput 1 加 -double 


8.5.9 无 刷 电动 机 控制 模型 数据 列表 
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8.5.4 无 刷 电 动机 功能 验证 模型 


完成 Stateflow 状态 图 之 后 ,在 Simulink 模块 库 中 找到 图 8. 5. 10 一 图 8. 5. 12 所 示 模 块 ， 
并 按 图 8. 5. 13 所 示 连 接 。 


-Si gal 人 Attributes 
-Signal Routing 
|-Sinjks 


UTCeES 


User-Defined 了 unctlons 

村 Adaditional Ilath 航 Discrete 
最 人 Aerospace Bl]ockset 
- 世 Comnuni cations Blockset 


图 8.S. 10 


Podel Yerification 
Model-Wide Utilities 
六 Ports 和 Subsystems 
Signal 人 Attributes 
Signal Routing 
Djxs 

-Sourees 

User-Defined Functions 


} 


Constsent 


常数 模块 


图 8.5.12 显示 模块 





| “iodeL-Wiade UtILIties 
Ports 和 Subsystems 
-Signal Attrlibutes 
Sinks 

'Soureces 


= User-Defined Punctilons 


提 Additional Math 衣 Diserete 


Mux 


图 8.5.11 集线器 模块 





图 8.5.13 功能 验证 模型 


将 Display 模块 的 维度 设置 为 6, 如 图 8. 5. 14 所 示 。 







最 Sink Block Parameters: Display 





uneric display of input Values， 


站 
| 
| 
| 
| 
| Paraneters 
4 


| Foraat; /Short 


[ADecination: 
6 


1 了 loating dl5sp1a7 











Peer 六 = 一 一 
汉 Eee EL 7 





图 8.5.14 设置 Display 模块 参数 


选择 模型 主 窗口 的 菜单 项 Simulation 一 Configuration Parameters. . . ,打开 模型 参数 对 话 
框 , 在 Solver 面板 中 ,设置 求解 器 为 定 步 长 离散 求解 器 , 步 长 为 0.01, 如 图 8.5. 15 所 示 。 


aa 


辆 :| 基于 模型 的 设计 一 一 MCU 篇 


Solver 0ptions 


Wu 





Fixed-step Size {fundamental Sample time}: 0.01 


图 8.5.15 求解 器 设置 
当 Key 王 1, 电 动机 处 于 打开 状态 时 , 若 霍 尔 传感器 状态 为 1, 则 第 2 和 第 6 路 PWM 信和 号 
导 通 ,输出 512。 信 和 号 占 空 比 是 由 PWMMR0 一 PWMMR6 联合 控制 的 ,输出 512 即 表示 占 空 
比 为 1 : 1, 如 图 8.5.16 所 示 。 





Chatt Ofi1 


图 8.5.16 仿真 结果 


8.S.5 软件 在 环 测 试 


在 模块 库 Smulink / Ports &Subsystems 中 找到 输入 模块 ,图 8. 5. 13 的 Constant 模块 ,用 输出 
模块 替换 mux 模块 和 display 模块 ,并 将 这 些 端口 的 数据 类 型 修改 为 unt32, 如 图 8. 5. 17 所 示 。 





图 8.5.17 代码 模型 


和 一 
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另外 还 需要 确保 Stateflow 模型 中 数据 的 类 型 也 应 为 uint32, 如 图 8. 5. 18 .图 8. 5. 19 
所 示 。 





Name 本 Blockfype OutDataTypesStr OutMin OutMax Lockscale DataType 中 
一 Waiaaihiiiipeaiiaiiaiaisiiiauaoalipeaiaiaaalaigialioiinier ua we ee 
| 归 Adviceforarm_BLDC 


乌 Configuration (Active) 


| 
| 
| 


已 Inl [ 0 四 
孔 T2 ] 昌 

马 In; 

| 耻 Chart 

己 out 0 下 
| 已 out2 [ - 
| 己 out [ 

已 Out4 日 日 苞 
| 已 0u65 0 0 

已 outk 0 斩 
已 ou 日 

| 互 out8 8 ] 

| 互 outs 8 
马 outlo [ 

已 outl 0 0 日 





图 8.5.18 修改 模型 端口 数据 类 型 


Name Scope Port Resolve 9gnal Datafype Size lnmalvalue Complledfype 4 





| 图 pinselo out. 1 辕 Uint3 

| 固 pinsel1 out .2 月 

图 ioodi out. 3 加 | 
-aa out. 4 回 
国 sensor Input 1 
图 key Input 2 
图 speed Input 3 
国 pwmmd out. 5 国 
园 pwmmaz ou 6 周 
| 国 psmma3 out. 7 加 

| 固 pwmmr4 out. 8 因 ; 
上 鸭 pwmmas out 9 辐 
国 pwmmr6 out_ 10 回 
国 pwmler out- 1 加 | 





图 8.5.19 修改 模型 内 部 数据 类 型 


在 Report 界面 中 , 勾 选 所 有 复 选 框 , 便 于 后 期 检查 及 跟踪 ,如 图 8. 5. 20 所 示 。 
打开 模型 的 参数 设置 对 话 框 , 在 Real-Time Workshop-SIL and PIL Verification 界面 
中 , 勾 选 Create SIL block 复 选 框 ,如 图 8. 5. 21 所 示 。 


网 7 
了 
可 399， 


浊 基于 模型 的 设计 一 一 MCU 篇 


局 Create code generation report 司 Launch report automatically 
Navigabon 
局 Code-to-model 
本 Software-inrthe- SL) and processor-in-the- PL) veriicaton 
团 wodeHtrcode [Caooea ie 0 
己 Enable portable word sizes 
Toy RPR Generate vertfication blocks 
可 负 minated /virtual blods 辣 Greate Sblodk 
让 Traceable Simulink blocks 
Code coverage 
局 Traceable Statefiow objects 
司 Traceable Embedded MATLAB fundt Code coverage tool: ;None ， Configure Coverage . 


在 Real-Time Workshop 界面 中 ,设置 TLC 文件 为 ert, tlc, 如 图 8. 5. 22 所 示 。 
单 击 模型 工具 栏 的 按钮 山 , 生 成 SIL 模块 ,如 图 8. 5. 23 所 示 。 





Target Selection 
System target file: ert.tkc [aowse .| 
Language: | 
Description; ReaFTime Workshop Embedded Coder 
RTW S-Function 
图 8.5.22 设置 TLC 图 8.5.23 SIL 模块 


如 图 8. 5. 16 所 示 , 以 SIL 模块 替换 Stateflow 模块 ,重建 图 8. 5. 24 所 示 的 验证 模型 。 由 
于 SIL 模块 是 根据 定点 模型 建立 的 ,因此 各 端口 间 加 入 了 数据 类 型 转换 模块 。 





Displ3) 
ConstaniC Daia Tipe Corwatsion2 


图 8.5.24 SIL 测试 模型 
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可 见 , 该 模型 的 运行 结果 与 图 8. 5. 16 的 结果 是 一 致 的 。 在 Dispjlay 模块 的 第 2.6 行 输出 
了 占 空 比 为 1:1 的 PWM 信号 。 


8.5.6 编写 驱动 代码 


无 刷 直流 电动 机 需要 一 组 PWM 信号 驱动 开关 电路 ,进而 根据 霍 尔 传感器 的 位 置信 号 有 
序 换 相 ,使 电动 机 能 够 持续 旋转 。 这 里 采用 ARM 芯片 上 集成 的 PWM 模块 来 产生 PWM 信 
号 ,因此 需要 为 其 添加 以 下 初始 化 代码 : 


# include "LPC2124.h" 

void PWM_Init(void) // 初 始 化 LEC2124 芯片 的 PWM 功能 
{ 

PWMPR = 1200; // 设置 分 频 系 数 

PWMMR0 = 1024; // PWMMRO 一 -PWMMR6 控制 初始 占 空 比 
PWMMR1 = PWMMR2 = PWMMR3 = PWMMR4 = PWMMR5 = PNMMR6 = 0; 
PWMMCR = 0x00000002; // 重 置 MRO 时 钟 

PWMPCR = 0x7FE00; // 使 能 PWM1 一 PWM6 输出 

PWMLER = 0x7F; // 使 能 PWM0 一 PWM6 锁 存 

PWMTCR = 0x09; // 使 能 PWM 模式 并 启动 定时 器 
} 


为 了 使 电动 机 具备 调 速 功 能 ,本 例 采用 电位 器 改变 输入 电压 值 , 进 而 控制 PWM 信和 号 的 占 
空 比 的 方式 实现 。 因 此 需要 添加 A/D 转换 相关 代码 


井 include"LPC2124.h” 

void MD _ Read(void) 

{ 
ADCR = (RDCR&0x00FFFF00) |0x01|(1 << 24); // 设置 通道 1, 并 进行 第 一 次 转换 
while( (ADDR&0x80000000)==0 ); // 等 待 转换 结束 
RDCR &= 一 0x01000000; // 停止 转换 


8.5$.7 自动 代码 生成 


添加 TASKING IDE FOR ARM 

选择 模型 菜单 项 Tools 一 Utilities for Use with TASKING(CR) IDE-~>Add Embedded IDE 
Link Configuartion to Model. . . ,为 模型 添加 IDE Link 选项 。 

选择 模型 菜单 项 Tools 一 Utilities for Use with TASKING(R) IDE 一 Target Prefer- 
ences, 选 择 ARM 选项 ,设置 其 目标 选项 ,如 图 8. 5. 25 所 示 。 

指定 xfwarm. exe carm, dol .ede. exe 这 三 个 文件 的 位 置 ,与 安装 路 径 有 关 。 例 如 D 愉 \ 
Program Files\TASKINGNcarm v3. 0r3\. . . ,指定 完毕 后 单 击 OK 按钮 ,如 图 8. 5. 26 所 示 。 

打开 模型 的 参数 设置 对 话 框 ,在 Hardware Implimentation 界面 中 ,设置 器 件 类 型 为 
ARM 7 ,如 图 8. 5. 27 所 示 。 


TV 站 | 
一 一 人 和 : 


贺 -- 基于 模型 的 设计 一 一 MCU 篇 


园 Target preferences Configuration Selection 
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图 8.5.2S 目标 选择 
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半 所 EDE_Confguration tasking.EDE_Congiguration 

| DOL Fe DNprogram FilesWTASAINGYarm v30Or3etcvcarm.dol 上 1 
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图 8.5.26 IDE 配 置 
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图 8.5.27 选择 芯片 

在 Embedded IDE Link 界面 中 ,设置 器 件 为 ARM, 如 图 8.5. 28 所 示 。 
Bulild Configuration 

Build action; [Create_ Application Project 


Target Preferences Configuration; Edit Comrflguratlon 


辣 Add build 由 rectory suffix 





Build directory suffix: 


图 8.5.28 Embedded IDE Link 界面 设置 
在 Real-Time Workshop 一 Custom Code 面板 中 的 Include Directories 文本 框 , 输 入 驱动 


”0 OO 
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代码 所 在 的 目录 ,如 D:\MATLAB FILES\ARM_BLDC _test( 图 8. 5. 29); Source Files 文本 


框 , 输 入 驱动 代码 文件 名 ,如 D:\ 人 MATLAB FILES\ ARM _BLDC test\PWM _ Init，c 


(图 8. 5. 30) ;在 Library Files 选项 , 填 人 库 文件 名 ,如 D:\MATLAB FILES\ARM_BLDC-_ 
test\LPC2124. h( 图 8. 5.31) 。 目 录 与 文件 路 径 ,必须 用 半角 双 引 号 包围 。 


广 Caomaents 









| Interface 


|-Code Style 
FTemplates 
Code Paceaent 


-Data Type Replace... 


一 ienory Sectlon5 
=-HDL Coder 

-Global Setting5s 

Test Bench 





Include list of additional: 


JInclude directories Source file3; 
files 「D:WUAILAB FILESVARI_BLDC_testVPWEL_Init.c” 


“ID:WIATLAB FILESVARN_ HBLDC_testVAD Readc” 


本 


| 


图 8.5.30 指定 原 代 码 
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| 9ource ft1]1es 
| Libraries 


图 8.5.29 设置 代码 目录 


Jnclude list of additiorial; 


| Include directories Libraries; 
人 “D:VIATLAB FILESVARN_BLDC_testWLPC2124.h- 


braties 
| 


图 8.5.31 指定 库 文 件 


单 击 模型 工具 栏 的 按钮 山 , 生 成 代码 的 报告 如 图 8. 5. 32 所 示 。 
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图 8.S$.32 代码 生成 报告 
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系统 自动 打开 TASKING EDE, 并 加 入 生成 的 代码 (图 8. 5. 33) 。 
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(人 和 坝 二 尖 拓 和 和 汪 和 和 站 和 的 册 交 让 让 让 二 克 交 丰 直 帮 才 让 起 让 放 者 
图 8.5.33 TASKING 工程 


打开 ert_main. c 文件 ,做 如 下 修改 : 
/1/# include < stdio. h> /*#* 在 后 面 的 代码 中 删除 函 数 printf/fflush, 因 此 不 需要 stdio.h * / 


# include "arm_BLDC.h* /*# 模型 头 文件 * / 

include "rtwtypes.h” / < MathWorks 数据 类 型 * / 
井 include "LPC2124.h" /# 添 加 DPC2124 头 文 件 * / 
extern void PWM Init(void) ; /x# 声 明 外 部 函数 PWM Init* / 
extern void AD Read(void) /x* 声 明 外 部 函数 apD_Readx / 
/ 关 


# ASSocliating rt_OneStep with a real-time clock or interrupt service routine 
* is What makes the generated code " real-time "The function rt_OneStep is 
# Balways asSSociated with the base rate of the mode1l1. Subrates are managed 
# by the base rate from inside the generated code， Enabling/disabling 
# interrupts and floating point context Switches are target Specific. This 
#_ example code indicates where these should take place relative to executing 
# 七 he generated code step function，Overrun behavior should be tailored to 
#* YOU application needs. This example Simply sets an error status in the 
# Teal-time model and returns from rt_OneStep. 
关 / 
volid rt_OneStep(void) ; 
void rt_OneStep(void) 
人 
static boolean_TOverrunFlag = 0; 


/#* Disable interrupts here #*/ 


。 .404。 
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1/ * Check for overrun < / 
if (OverrunFlag) !{ 
rtmSetErrorStatus(arm_BLDC M,，"Overrun ”) ; 


Teturn; 


OverrunFlag = TRUE 


/ x* Save FPU context here (if necessarV) # / 
/ x* Re-enable timer or interrupt here # / 
/ * Set model inputs here */ 
arm_BLDC_U. In1 = (IO0PINS0x03800000)>> 23; 
arm_BLDC U. In2 (IO0PIN&0x8000)>> 15; 
/ # Step the model x# / 
arm_BLDC step() ; 
/ * Get model outputs here x* / 
PINSEL0O = arm_BLDC Y, Outl; 
PINSEL1 = arm_BLDC Y, Out2; 
IOODIR = arm BLDC_ Y.Out3; 
PWMMR0 = arm BLDC_Y. Out4; 
PWMMR1 = arm_BLDC Y.Out5; 
PWMMR2 = arm BLDC Y. Dut6; 
PWMMR3 = arm _BLDC Y. Out7; 
PWMMR4 = arm_BLDC_Y.Out8; 
PWMMR5 = arm_BLDC_ Y.Out9; 
PWMMR6 = arm_BLDC Y,.Out10; 
PWMLER = arm BLDC Y. Dutl1l; 
/# Indicate task complete * / 
OverrunFlag = FRLSE; 


/*#* Disable interrupts here x / 
/ #* Restore FPU context here (if necessary) * / 


/# Enable interrupts here x / 


1 关 


// 模 型 输入 口 与 硬件 相关 联 


// 模 型 输出 口 与 硬件 相关 联 


x The example "main”function illustrates what is required by Vour 


#_ application code to initialize，execute，and terminate the generated code. 


闪 有 ttaching rt_OneStep to a real-time Clock ls target Specific. This example 
# llustates how You do this relative to initializing the model. 


细 ， 
int_T main(int_T argc，const char T * argv[]); 
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int T main(int T argc，const char T * argv[ ]) 
{ 
1/ xx Initialize model x / 
arm_BLDC initialize(); 
PWM_Init(); // 调 用 PWM_Iint() 
RDCR = 0x002E0401; //aADC 初始 化 
/xx#* Simulating step behavior xy/ 
while (rtmGetErrorStatus(Carm_BLDC M) == (NULL) ) { 


RD_Read() ; // 调 用 aD_Read() 
arm_BLDC 0. In3 = (RDDR>> 6) & 0x3FF; // MD 转换 结果 赋值 到 In3 口 
rt_OneStep() ; // 调 用 rt_OneStep() 


/ #< Disable rt_OneStep() here x*/ 


1/ # Terminate model #x/ 
arm_ BLDC_ terminate(); 


return 0 ; 


1 关 
# Filetrailer for Real-Time Workshop generated code. 


和 
x [EOF] 
关 / 


单 击 EDE 环境 的 工具 栏 按钮 Y ,打开 工程 选项 窗口 (图 8. 5. 34) ,在 Linker->Outpnut 
Format 界面 中 , 勾 选 Intel Hex records for EPROM programmers(. hex) 复 选 框 。 


VX-toolset for ARM project Options [ARM 7 






| 由- Processor Jegfinition Dutput Format 
因 C++ [Conpiler 三 PLFADWARF for debaggers und loadearg (由 5) 


岂 As368b] 人 三 Wotorola S records for PPRON progranaers (sre) 
呆 .Linjker 
0utput Format 只 
Libraries and Data 0hject 
由 Script 7ile 售 Inhtel ] 下 X records for PERDON prograaners [hex) | 
二 t | 
六 Size of addresses (bytes) for Intel 呀 X R 了 ] 
Wiagnostiecs 
用 scellaneous 三 Library for TASIIRG NB Liajker (1ib) 


用 [rogss 册 6 Pro 


0ptions String: 
| 


-6 hex” 一 Format=ihex - 们 -c “SIHEX:4 - 们 一 六 
工 $DRODIDIR)NLib” -dr _arm_bldc1sl”- 们 -0cLtXT -用 =- - 科 - 











图 8.5.34 设置 输出 HEX 文件 
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再 单 击 工具 栏 按钮 省 ,编译 工程 ,窗口 下 部 的 信息 显示 已 成 功 生成 . hex 文件 。 


TASKING program builder v3.0r3 Build 088 

Compiling ". .N\.,.Narm bldc_ert_rtw_arm_simNarm bldc.c" 
Rssembling ”arm bldc. srcy” 

Compiling ". .\..Narm bldc_ert_rtw_arm_ sijmNert main.c" 
Rssembling "ert_main. src" 

Compiling ". ,\. .Npwm_init,c" 

Rssembling "pwm_ init. src" 

Assembling "ad read. src" 

Linking and Locating to Intel Bex format files 


值得 一 提 的 是 TASKING VX-toolset for ARM 开发 环境 针对 ARM 芯片 做 了 特别 的 优 
化 处 理 ,编译 后 效率 会 优 于 KEIL 开发 环境 。 在 TASKING 工程 所 在 目录 下 找到 该 文件 ,查看 
其 属性 ,如 图 8. 5. 35 所 示 ,文件 大 小 仅 为 4KB 左右 。 

由 于 作者 所 使 用 的 Proteus 7. 7 版 本 不 支持 TASKING VX-toolset for ARM 生成 的 
HEX 文件 格式 ,因此 在 后 一 小 节 的 虚拟 硬件 测试 中 使 用 了 由 KEIL 生成 的 .hex 文件 。 

若 将 TSKING VX-toolset for ARM 生成 的 hex 文件 下 载 到 合适 的 硬件 执行 ,就 不 会 受到 
此 种 情况 的 限制 ,但 作者 并 未 作 此 项 测试 ,有 兴趣 的 读者 可 自行 测试 。 







arm_bldc.hex 屋 性 


| 弟 讽 去 全 详细 全息] 凡 商 的 版 本 






人 月 bdc. hex 






文件 类 型 : JEX 文件 〔 hex) 
| 打开 方式 双 finiovs 外 址 公用 贡 三 更 区 扣 













位 置 : 了 :WATLAE 了 FILESAARI BIDC_testert_ rtw_arnm 

大 小 : 

占用 空间 : 6.00 聊 (8 192 字 节 ) 
AN EN 


4.06 取信 161 字 节 






图 8.5.35 .hex 文 件 属性 


8.5.8 代码 效率 比较 


NXP 公司 的 官方 网 站 上 提供 了 基于 LPC2141 芯片 的 无 刷 电 动机 控制 应 用 笔记 ,用 户 可 
以 到 网 站 http://www. nxp. comy/ # /search/params 一 [q 王 AN10661,p 三 1,1= 一 en]lfilters 一 
口中 下 载 文 件 AN10661 Brushless DC motor control using the LPC2141 ,该 应 用 笔记 给 出 了 
完整 代码 (USB_Init/USB_connect 函数 除外 ) 。 本 例 所 建 模型 和 NXP 官方 应 用 笔记 中 的 实例 
功能 基本 相同 ,因此 代码 具有 一 定 的 可 比 性 。 

不 同 之 处 在 于 ,本 例 的 代码 是 基于 LPC2124 芯片 的 ,而 NXP 采用 的 是 LPC2141 芯片 。 
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这 是 由 于 将 会 在 下 一 小 节 中 进行 Proteus 虚拟 硬件 测试 。 遗 性 的 是 Proteus 并 不 支持 
LPC2141 芯片 ,因此 本 例 采 用 了 相近 的 LPC2124 代替 。 由 此 引起 的 代码 差异 是 非常 小 的 , 基 
本 可 以 忽略 。 

在 自动 生成 的 代码 中 ,主要 由 arm_BLDC. c 实现 模型 所 表达 的 算法 ,其 他 文件 为 头 文件 、 宏 
定义 .函数 声明 等 ,有 兴趣 的 读者 可 以 自行 查看 。 下 面 列 出 arm_BLDC. c 代码 (注释 行 已 删除 ) : 


# include "arm_BLDC.h"” 
井 include "arm_BLDC_private.h" 


站 define arm_BLDC_IN 及 《10) 
# definearm_BLDC_IN_B (20U) 
井 define arm_BLDC_IN_C (30U) 
井 define arm_BLDC_ IN D 《40U) 
间 defline arm_BLDC_IN BE 《50U) 
井 define arm_BLDC_IN F 《6U) 
# define arm_BLDC_IN_Init (1U) 
井 define arm_BLDC_IN_MotorOff (1U) 
# define arm_BLDC_IN_MotorOn (20U) 


# define arm_BLDC_IN_NO_ACTIVE_CHILD 《0U) 
BlockIO_arm_BLDC arm_BLDC_B; 
D_Work_arm_BLDC arm_BLDC_DWork; 
ExternalInputS_arm_BLDC arm_BLDC_Ui; 
ExternalOutputs_arm_BLDC arm_BLDC_Y; 
RT_MODEL_arm_BLDC arm_BLDC M_; 
RT_MODFEL arm_BLDC # arm _BLDC NM = &arm _BLDC_ M_; 
void arm_BLDC_step(void) 
人 
if (arm_BLDC_DWork. is_active_cl_arm_BLDC == 0) { 
arm_BLDC_DWork,. 1S_active_cl_arm_BLDC = 10U; 
arm_BLDC_DWork. 1s_cl_arm_BLDC = arm_BLDC_IN_Init; 
arm_BLDC_B. io0dir = 0U; 
arm_BLDC_B. pinsel0 = (uint32_T)0x000R800R; 
arm_BLDC_B. pinsell = 〈uint32 T)0x00400800; 
arm_BLDC_DNWork. is_Init = arm HLDC_IN _ MotorOff; 
arm_BLDC_B. pwmmr0 = 1024U; 
arm_BLDC _B. pwmmrI = 0U; 
arm_BLDC_B. pwmmr2 = 0U; 
arm_BLDC_B. pwmmr3 = 0U; 
arm_BLDC_B, pwmmr4 = 0U; 
arm_BLDC_B,. pwmmr5 = 0U; 
arm_BLDC_B. pwmmr6 = 0Ui 
arm_BLDC_B, pwmler = 《uint32_T)0x7F; 
) else { 
Switch (arm_BLDC_DWork, is_Init) { 
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Case arm _BLDC_ IN _ MotorOftf , 
if (arm_BLDC U. In2 == 1U) { 
arm_BLDC_DWork,. is_Injt = arm_BLDC_IN_MotoroOn; 
} 
brealjkk; 
Case arm_BLDC_IN_MotorOn; 
if (arm_BLDC_U. In2 == 0U) 《 
azri_BLDC_DWork. is _Motoron = (uint8_T)arm_BLDC_IN_NO_RMCTIVE_CHILD; 
arm_BLDC _DWork. is_Init = arm_BLDC_IN_MotorOff; 
arm_BLDC B. pwmmr0 = 10240Ui 
arm_BLDC_B,. pwmmrl = 0U; 
arm_BLDC_B,. pwmmr2 = 0U; 
arm_BLDC_B3. pwmmr3 = 0U; 
arm_BLDC_B. pwmmr4 = 0U; 
arm_BLDC_B. pwmmr5 = 0U; 
arm_BLDC_B. Pwmmr6 = 0U; 
arm_BLDC_B. pwmler = (uint32_T)0x7F; 

} else 诗 (arm_BLDC U. Inl == 5U) { 
arm_BLDC_DWork. is _Motoron = arm_ BLDC_ IN Ai 
arm_BLDC _B, pwmmr0 = 1024U; 
arm_BLDC_B. pwmmrl = arm_BLDC U. In3; 
arm_BLDC_B. pwmmr2 = 0U; 
arm_BLDC_B. pwmmr3 = 0Ui 
arm_BLDC _B. Pwmmr4 = 0U; 
arm_BLDC_B. pwmmr5 = 0U; 
arm_BLDC_B. pwmmr6 = arm BLDC U. In3; 
arm_BLDC_B. pwmler = (uint32_T)Ox7E; 

)》else if (arm_BLDC_ U, Inl == 40)【 
arm_BLDC _DWork. is_Motoron = arm BLDC_ IN _BI 
arm_BLDC_B. pwmmr0 = 1024U; 
arm_BLDC B. pwmmrl = arm _BLDC U. In3; 
arm_BLDC _B. pwmmr2 = 0Ui 
arm_BLDC_B. pwmmr3 = 0Ui 
arm_BLDC _B. pwmmr4 = 0Ui; 
arm_BLDC_B. pwmmr5 = arm_BLDC_U. In3; 
arm_ _BLDC_B. pwmmr6 = 0U; 
arm_BLDC _B. pwmler = (uint32_T)0x7F; 

} else if (arm_BLDC U. Inl == 6U) 《 
arm_BLDC_DNork. is_Motoron = arm_BLDC_IN_C; 
arm_BLDC _B,. pwmmr0 = 10240U; 
arm_BLDC _B. pwmmrl = 0Ui 
arm_BLDC B. pwmmr2 = 0Ui; 
arm_BLDC_B. pwmmr3 = arm_BLDC U. In3; 
arm_BLDC_B. pwmmr4 = 0U; 
arm_BLDC_B. pwmmr5 = arm_BLDC U. In3; 
arm_BLDC_B. pwmmr6 = 0U; 
arm_BLDC_B. pwmler = (uint32 _T)0Ox7F; 
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) else if (arm_BLDC_ U. Inl == 2U) { 
arm_BLDC_DWork. is_MotorOn = arm_BLDC_IN_Di 


arm_BLDC _B. pwmmrO 
arm_BLDC_B. pwmmr1 
arm_BLDC _B. Pwmmr2 
arm_BLDC_B. pwmmr3 
argm_BLDC_B. pwmmr4 
arm_BLDC_B. pwmmr5 
arm_BLDC_B. pwmmr6 
arm_BLDC_B. pwmler 


= 10240U; 

= 0U; 

= 0U; 

= arm_BLDC_U. In3; 
= arm_BLDC_U. In3; 
= 0U; 

= 0U; 

= (〈uint32 T)O0x7F; 


}) else iE (arm_BLDC_U. Inl == 3U) { 
arm_BLDC_DWork,. is_Motoron = arm_BLDC _IN_B; 


arm_BLDC_B. pwmmrO 
arf_BLDC_B. Pwmmr1 
arm_BLDC_B. pwmmT2 
arm_BLDC_B,. pwmmr3 
arm_BLDC 了 B. pwmmr4 
arm_BLDC B. pwmmr5 
arfm_BLDC _B. pwmmr6 
arm_BLDC_B. Pwmler 


} else { 


= 1024U; 

= 0U; 

= _ arm BLDC U. In3 ; 
= 0Ui 

= arm_BLDC_ U. In3; 
= 0Ui; 

= 0U; 

= (〈(ulnt32 T)0x7F; 


iFE《〈arm_BLDC_ U. In1 == 1U) 《 
arm_BLDC_DWork. is_Motoron = arm_BLDC_IN_F; 
arm_BLDC_B. pwmmr0 = 1024UI 
arm_BLDC B, Pwmmrl = 0U; 
arm_BLDC _B. pwmmr2 = arm_BLDC_U. In3; 
arm_BLDC B. Pwmmr3 = 0U; 
arm_BLDC_B. pwmmrd4 = 0U; 
arm_BLDC _B. Pwmmr5 = 0U; 
arm_BLDC _B. pwmmr6 = arm_BLDC_U. In3; 
arm_BLDC _B. pwmler = (ulint32 T)Ox7F; 


} 
break; 
defaul] 七 : 


arm_BLDC_DWork. is_Init = arm_BLDC_IN_MotorOffs 


arm_BLDC_B. pwmmr0 = 
arm_BLDC_B. pwmmrl = 
arm_BLDC _B. pwmmr2 = 
arm_BLDC_B. Pwmmr3 = 
arm_BLDC_B. Pwmmr4 = 
arm_BLDC_B. pwmmr5 = 
arm_BLDC_B. pwmmr6 = 
arfm_BLDC B. pwmler = 
break; 


1024U; 

0U; 

0U; 

0U; 

0U; 

0U; 

0U; 
(uint32_T)Ox7F; 
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arm_BLDC_ Y. Outl = arm_BLDC B. pinsel0; 
arm_BLDC_ Y. Out2 = arm_BLDC B. pinsell; 
arm_BLDC Y. Out3 = arm_BLDC B. io0dir; 
arm_BLDC Y. Out4 = arm_BLDC B. pwmmr0: 
arm_BLDC Y.0Out5 = arm_BLDC B,pwmmrl; 
arm_BLDC Y. Out6 = arm_BLDC B. pwmmr2; 
arm_BLDC Y. Out7 = arm_BLDC B. pwmmr3; 
arm_BLDC_ Y. Out8 = arm_BLDC _B.pwmmr4; 
arm_BLDC_Y. Out9 = arm_BLDC _B. pwmmr5; 
arm_BLDC Y. Out10 = arm_BLDC_B. pwmmr6; 
arm_BLDC Y. Out1l1l = arm_BLDC B. pwmler; 
} 
void arm_BLDC_initialize(void) 
rtmSetErrorStatus(arm_BLDC M，(NULL) ) ; 
(void) memset(((void #* ) &arm BLDC B)，0， 
Sizeof(BlockIO_arm_BLDC) ) ; 
(void) memset((void * )&arm _BLDC_DWork，0， 
Sizeof(D Work_arm_BLDC) ) ; 
(void) memset((void * )&arm BLDC U，0， 
sizeof(ExternalInputs_arm _BLDC) ) ; 
(void) memset((void #* )&arm BLDC Y，0， 
sizeof(ExternalOutputs_arm_BLDC) ) ; 
arm_BLDC_DWork. is_Init = 0U' 
arm_BLDC_DWork. 1s_Motoron = 00U; 
arm_BLDC_DWork. is_active_cl_arm_BLDC = 0U; 
arm_BLDC_DWork. is_cl_arm_BLDC = 0U; 
arm_BLDC_B. pinsel0 = 0U; 
arm_BLDC_B.pinsell = 00U; 
arm_BLDC_B, io0dir = 0Ui 
arm_BLDC_B, pwmmr0 = 0U; 
arm_BLDC_B. pwmmrl = 0U; 
arm_BLDC_B. pwmmr2 = 0U; 
ar 有 _BLDC B. pwmmr3 = 0U; 
arm_BLDC _B, pwmmr4 = 0U; 
arm_BLDC_B. pwmmr5 = 0U; 
arm_BLDC_B. pwmmr6 = 0U; 
arm_BLDC_B. pwmler = 0Ui 
} 
volid arm_BLDC_terminate(void) 
{ 
} 


NXP 公司 提供 的 代码 中 adc. cbldc. chsensor, c` PWM. ctimerl. ec 代码 均 为 实现 算法 
所 必须 ,bldc. ec 为 函数 声明 文件 读者 可 自行 查看 。 下 面 列 出 其 算法 代码 。 
Adc.c 文件 


井 include < LPC214x. h > 
void AMDC0O_Init(volid) 


有 -3 
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{ 

PINSFELI | = 0x00040000; /1/ pB0.25 = RAINO.4 

haMDOCR = 0x00200F10; // initialise MDC0，select RAIN4 

RMDOCR | = 0x00010000;，// start burst mode now，sSee errata ADC. 2 


} 
Bldc. c 文件 


# include < LPC214x.H> // LEC214x definitions 
井 include "bldc.h" 


unsigned char actualSpeed = 0; 
unsigned char desiredSpeed = 0; 
unsligned int RPM,fRPM; 


void GetInReport(unsigned char * rep) // Host is asking for an InReport 
人 


repL0] = fRPM; // send measured motor Speed (low byte) 
repL1] = fRPM >> 8; // send measured motor speed (higqh byte) 
repL2]】= RDODR4 >> 8;; // send potm value for debugging 


} 


void SetOutReport(unsigned char # rep) // 0utReport received from USB host 
{ 

if (rep|0] < 101) 

desiredSpeed = repL0]; // New desired speed value recelived 


} 


int main (volid) 
{ 
ADC0_Init(); // ADCO Initialization 
T1_JInit(); // 10 msec tick 
PWM_Init(); // PWM Timer Initialization 
HES_Init(); 

// USB_ Init();， // USB Initialization 

// USB_ Connect(1);，// USB Connect 


while(1) // Loop forever 

{ 

让 (((RARDODR4 >> 8) & 0xFF) > MAX Im) // Check motor overcurrenrt 
{ 

VICIntEnClr = 0xFFFFFFFF; // disable all interrupts! 
PWMMR1 = 0; // 0Q1 off 

PWMMR2 = 0; // 02 off 

PNMMR3 = 0; // 03 off 

PWMMR4 = 0; // 0Q4 off 

PWMMR5 = 0; // 05 off 

PWMMR6 = 0; // 06 off 
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PWMLER = 0x7F; // enable PNM0O-PWM6 match latch (reload) 
While (1) ;， /wait for a RESET 

} 
if (f_ 10ms) // every 10 mseconds 


{ 
f_ 10ms = 0; 


放 (actualSpeed > desiredSpeed) 
actualSpeed 一 一 ; 

else 这 (actualSpeed < desiredSpeed) 
actualSpeed ++ ; 


RPM = 10000000 / TOCR0; // calculate motor speed 
fRPM = ((fRPM x* 15) + RPM) / 16; // filter 让 tL 

} 

} 

} 


Hsensor. c 文件 


## include < LPC214x. 日 > // LPC214x definitions 
# 井 include "bldc.h"” 


_irq void T0_Isr(Vvoid) 


{ 
TOTC = 0; // Reset timer 


switch ((IOOPIN >> 18) & 7) // read Hall sensor inputs P0.18，P0,19 and P0.20 


《 
case 1 : PWMMR1 = actualSpeed; // phase 6: 001 


PWMMR2 = 0; 

PWMMR3 = 0 

PWMMR4 = 0; 

PWMMR5 = 0; 

PWMMR6 = actualSpeedi; 
break; 


case 2: PWMMR1 = 0; // phase 4: 010 
PWMMR2 = actualSpeed; 


PWMMR3 = 0; 

PWMMR4 = actualSpeed; 
PWMMR5 = 0; 

PWMMR6 = 0; 

break; 


case 3:; PWMMR1 = 0; // phase 5:; 011 
PWMMR2 = actualSpeedi 


PWMMR3 = 0; 
PNMMR4 = 0; 
PWMMR5 = 0; 
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PWMMR6 = actualSpeed; 


break; 

case 4: PWMMR1 = 0; // phase 2: 100 
PWMNMMR2 = 0; 

PWMMR3 = actualSpeedi; 

PNRMMR4 = 0; 

PWMMR5 = actualSpeed; 

PWMMR6 = 0; 

break; 

case 5:， PWMMR1 = actualSpeed; // phase 1: 101 
PWMMR2 = 0; 

PWMMR3 = 0; 

PWMMR4 = 0; 

PWMMR5 = actualSpeedi 

PWMMR6 = 0; 

break; 

case 6:， PWMMR1 = 0; // phase 3: 110 
PWMMR2 = 0; 


PWMMR3 = actualSpeed; 


PRMMR5 = 0; 
PWMMR6 = 0; 
break; 


default:， break; // invalid 
} 


TOIR = 0xFF; // reset flags 

PWMLRER = 0x7F; // enable PWM0O - PWM6 match latch (reload) 
VICVectaddr = 0;i // Rhcknowledge interrupt by reseting VIC 
} 


void HES_Init(void) 

人 

VICVectahddr1l 《unsigned int) &T0_ Isri 

VICVectCnt11 0x24; // Channell on Source 井 4 . .enabled 
VICIntEnable | = 0xl0; // Channe1l#4 is the Timer 0 


PINSFL1 | = 0x3M000000; // B0.30,P0.28,P0.29 as CRP0.0,CRP0.2,CRP0.3 


TOPR = 60; // pre 60，timer runs at 60 MHz / 60 = 1 MHz 

TOMR0O = 1000000; // = 1 sec/ 1 us 

TOMCR = 3j; 

TOCCR = 0x0FC7; // Capture on both edges and enable the interrupt 
TOTC = 0; // Reset timer 

TOTCR = 1; // start timer 

} 
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PWM.c 文件 


井 include < LEPC214x.h>> 


void PRM_ Init(void) 


人 


PINSREL0 
PINSEL1 


PWMPR 
PWMPC 
PWMTC 
PWMMRO0 
PWMMR1 
PWMMR2 


| = 0x0008M800R; // select PWM1-4 and PWM6 
| = 0x00000400; // select PWM5 


20; // prescaler to 20，timer runs at 60 MHz / 20 = 3 MHz 
0; // prescale counter to 0 
0; // reset timer to 0 


= 100; // -> PMW base frequencYy = 3 MHz / 100 = 30 KHz 
= 0j;j // Match 1 for 01〈(off) 

= 0; // Match 2 for 02 (off) 

= 0; // Match 3 for 03 (off) 

= 0; // Match 4 for 04 (off) 

= 0; // Match 5 for Q5 (off) 

= 0; // Match6 for 06 (off) 

= 0x00000002; // reset TC on MRO 

= 0x7E00; // enable PRM1 - PWM6 outputs 

= 0x7E; // enable PWMO0 - PWM6 match latch (reload) 
= 0x09; // enable PWM mode and start 七 imer 


Timerl. c 文件 


井 include < LPC214x.H> // LPC214x definitions 


char f 10ms = 0; 


_ irg void T1_Isr(void) // Timer 1 ISR every 10 msec 


{ 
二 10ms 


= 1; // toggles every 10 mseconds 


T1IR = 
VICVectaddr = 0; // reset VIC 


} 


0x01; // reset interrupt flag 


void T1_Init(Cvoid) 


{ 


VICVectaddr2 = (unsigned int) &T1_Isr; 
VICVectCnt12 = 0x25; // Channe12 on Source 寺 5 . .enabled 
VICIntEnable | = 0x20; // Channe1l 并 5 is the Timer 1 


T1MRO0 
T1MCR 


上 


600000; // = 10 msec / 16,67 nsec 
3i; // Interrupt on Match0 ，reset timer on match 


1 Pelk = 60 MHz，timer count = 16,67 nsec 


T1TC = 0; // reset Timer counter 
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TITCR = 1; // enable Timer 
}》 


通过 代码 量 的 比较 ,可 以 较 直 观 地 看 出 ,自动 生成 的 代码 已 经 很 接近 手写 代码 的 效率 了 。 
下 面 将 进一步 比较 代码 编译 后 的 . hex 文件 。 

在 Keil 中 建立 工程 ,将 修改 过 的 自动 生成 代码 添加 到 工程 中 ,编译 生成 . hex 文件 ,如 图 
8.5. 36 所 示 。 
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||compiling arm BLDC.c, 
Hecompiliing ert main.c,.， 
日 compiling PWM Init.c.,，。 
||iccmpiling RD Read.c。.， 





目 Limnking,,。 

HPzogram 3ize: Code=2720 RO-data=32 RNW-data=16 2I-data=1360 
[FFcmELF， creating hex file,,， 

Re - 0 Error(s) ，0 Warning(s) 。 


图 8.5.36 编译 信 息 
在 工程 目录 下 可 以 找到 生成 的 . hex 文件 ,查看 其 属性 。 可 以 看 到 文件 大 小 为 ?7.65KB, 如 
图 8.5.37 所 示 。 
BLDC.hex 许 性 


讽 二 信和 |5NR9 上 本 





BIDIChex 


| 文件 业 型 :JEX 文件 〔 hex) 





打开 方式 :。 沁 申 ndows 外 过 公用 0 三 更 改 拉 | | 


位 置 : [AUsers\BoBo\Desktop\BLIC 
| /大 小 : 7.65 葡 (7 836 字 节 ) 
| \ 上 用 空间 :8.00 王 (6 192 字 节 ) 





图 8.5.37 HEX 文 件 咯 性 
接 下 来 ,建立 一 个 新 的 Keil 工程 ,加 和 人 NXP 官方 代码 ,编译 生成 . hex 文件 ,如 图 8. 5. 38 所 示 。 
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| 如 NGP RDC -Wision3 Ra 局 二 让 动 
TD Riohoae oa Wi 

区 台 妇 过 这 三 路 志 衣 : 检 
TI 全 oo -民生 





Source Group 1 | #3Pclcde < 工 FC213X。8B> 
| #IPCiQde "blSc 0 ” 
内 >tartup5 
risigned Char aczoal5peed = D; 
ansigned char des5lxed3peecd = 
onsigned int REN,ZREN; 


补 ] 
全 
习 P 严 
忆 
时 旭 : 
和 


Vyoid Se5IFRepozc ionsigned char “zep) 


由 
吧 
| 的 
| 出 
护 
此 
太 
全 
中 





11Inking。.。， | 
Program Si2el Code=2548 RO-daata=32 RW-aata=16 3I-Qata=1256 让 

FromELEF: creating hexX file..， | 
"NXP BLDC.axf”- 0 Error(s)，8 Warning(s) . 至 | 
| 
| 
| 





图 8.5.38 编译 信息 
在 工程 目录 下 找到 生成 的 . hex 文件 ,查看 其 属性 。 可 以 看 到 文件 大 小 为 7. 18KB, 如 
8. 5. 39 所 示 。 这 再 次 证 明了 自动 生成 代码 的 效率 并 不 逊色 于 手写 代码 。 
NXP_BLDC ,hex 屋 性 


| 关 “十 访 机 的 于 





JRP_BLDC.hex 


文才 类型 加 许 (ha) 


| 打开 方式 吉 Yindos 儿 帝 人 用 I 人 本 GD] 


位 置 : [C: Users\BoBoADesktopALFC offical blde_eo 
大 小 : 7T.18 邢 和 ,362 字 节 ) 
占用 空间 8.00 好 人 @, 192 字 节 ) | 





图 8.5.39 .hex 文 件 属性 


8.5.9 虚拟 硬件 测试 


建立 驱动 无 刷 电 动机 模型 。 桥 式 逆 变 电 路 控制 电动 机 驱动 电动 机 正常 运转 ;IR2112 提供 
足够 的 导 通 电压 ;Logicstate 控制 电动 机 是 否 开 始 工作 ;电位 器 调节 输入 电压 ,控制 电动 机 转 
速 ; 示 波 器 显示 6 路 PWM 信号 的 波形 ,如 图 8. 5. 40 所 示 。 
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图 8. 5. 40 “Proteus 原理 图 


由 于 使 用 元 件 较 多 ,为 避免 混乱 ,采用 网 络 标 号 的 方法 连接 元 件 。 分 别 在 在 LPC2124 芯片 的 
P0. 0.P0. 1、.P0.7、.P0.8、P0.9.P0. 21 引 脚 标注 V1`V3、V2、V4、V6、V5 ,输出 6 路 PWM 信和 号;P0. 23、 
Po0. 24.P0. 25 引 脚 标注 Ha .Hb Hec, 表 示 霍 尔 元 件 的 输入 ;P0. 15 直接 连接 Logicstate,P0. 27 直接 连 


接 电位 器 ,如 图 8. 5. 41 所 示 。 


P0.10RTS1TICAP10 
P0O.11CTSTCAPT1:T 
P0.12/DSR1AMAT1D 
PO.13/DTR1AMATTT 





图 8.5.41 元 件 引 叶 连 接 








IR2112 芯片 按 图 8. 5. 42 连接 ,三 个 芯片 的 HIN 引 脚 分 别 标注 V1 一 V3,LIN 引 脚 标注 
V4 一 V6;HO 引 脚 标注 H1 一 H3,LO 引 脚 标 注 L1 一 L3。 





图 8.5.42 IR2112 引 脚 连接 


在 桥 式 闭 变 器 的 功率 管 引 脚 处 标注 HI 一 H3,LI 一 L3, 与 IR2112 的 对 应 引 脚 相连 接 ; 电 动机 右 
侧 的 三 根 引 脚 分 别 标注 Ha、Hb Hec, 将 址 尔 传感器 的 值 输入 到 芯片 中 去 ,如 图 8. 5. 43 所 示 。 





图 8.5.43 元 件 设 置 


选择 左 侧 示波器 中 的 4 根 引 脚 ,标注 V1 一 V4, 右 侧 示 波 器 的 A,B 两 根 引 脚 ,标注 V5， 
V6, 用 以 显示 6 路 PWM 输出 信号。 

由 于 IR21I2 芯片 的 输入 电压 (CHIN .LIN) 不 能 低 于 Vob-0.3V, 而 LPC2124 输出 的 PWM 
波 为 3. 3 V,proteus 系统 默认 的 Vop 为 5 V, 这 会 导致 IR2112 无 法 正常 工作 。 在 菜单 栏 上 选 
择 Design->Config Power Rails ,将 Vop 设 置 为 3.3V, 如 图 8.5.44 所 示 。 


间 一- wa 
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完成 上 述 设 置 后 ,加载 之 前 由 Keil 生成 的 . hex 文件 , 单 击 “ 仿 真 ” 按 钮 。 可 以 看 到 ,电动 机 
正常 运行 ,符合 模型 预期 功能 ,如 图 8. 5. 45 所 示 。 
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MOTOR-BLDCNM 
图 8.5.44 设置 Von 图 8.5.45 仿真 结果 


由 图 8.5.45 可 知 , 当 前 时 刻 由 霍 尔 传感器 输出 的 信号 为 010, 对 应 的 十 进 制 数 为 2, 当 
sensor 值 为 2 时 ,PWM 输出 波形 如 图 8. 5. 46、 图 8. 5. 47 所 示 。 


Drgasl Docoscspn 训 








图 8.5S.46 输出 PWM 波形 图 8.5.47 输出 PWM 波形 


用 户 还 可 以 再 添加 一 个 示波器 ,将 示波器 的 A.B.C 三 根 引 脚 连接 到 电动 机 左 侧 的 三 个 引 
脚 ,可 以 观察 到 图 8. 5. 48 所 示 的 波形 。 在 一 个 完整 的 周期 内 ,三 路 信号 呈 120 相位 差 。 





图 8.5.48 输入 电动 机 的 波形 


.420 
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本 章 以 第 2 章 电动 机 的 PID 控制 模型 为 例 , 介 绍 基于 模型 的 设计 的 完整 过 程 , 它 是 对 本 
书 的 总 结 , 也 是 本 书 的 核心 内 容 。 

在 本 章 中 ,作者 给 出 了 符合 DO-178b 航空 电子 规范 的 基于 模型 设计 的 工作 流程 。 并 按照 
这 个 设计 流程 ,对 电动 机 的 PID 控制 模型 进行 了 相关 测试 与 验证 。 由 于 作者 的 MATLAB 捅 
件 中 缺少 Polyspace 捅 件 (Polyspace 插件 售 价 据说 在 10 万 美元 左右 ), 无 法 对 模型 生成 的 代 
码 进行 运行 时 的 错误 检查 。 但 是 作为 一 个 完整 的 基于 模型 的 设计 ,对 生成 的 代码 进行 运行 时 
的 错误 检查 是 必 不 可 少 的 ,特别 是 对 于 某 些 对 可 靠 性 及 稳定 性 要 求 非常 高 的 项 目 , 例 如 航天 与 
军工 行业 ,运行 时 错误 检查 是 极为 重要 的 。 否 则 20 世纪 80 年 代 , 欧 洲 阿 丽 亚 娜 火箭 发 射 失败 
的 悲剧 可 能 重演 , 带 来 的 将 是 灾难 性 的 后 果 。 

考虑 到 介绍 基于 模型 设计 的 完整 流程 会 占用 大 量 篇 幅 , 作 者 对 第 5 章 到 第 8 章 的 基于 模 
型 的 设计 的 工作 流程 做 了 简化 。 因 此 前 面 几 章 并 不 是 真正 意义 上 的 基于 模型 的 设计 ,只 能 算 
是 MCU 器 件 散 和 人 式 C 代码 的 快速 生成 。 

如 果 读 者 想得到 高 效 的 ,高 可 靠 性 的 嵌 人 式 实 时 C 代码 ,基于 模型 设计 的 工作 流程 必须 
参照 本 章 介绍 的 步骤 进行 。 

本 章 的 主要 内 容 : 

@ 传统 设计 的 弊端 。 

@ 基于 模型 设计 的 优势 。 

@ 基于 模型 设计 的 流程 。 

@ 需求 分 析 及 跟踪 。 

@ 模型 检查 及 验证 。 

@ 定点 模型 。 

@ 软件 在 环 测 试 。 

@ 代码 跟踪 。 

@ 代码 优化 及 代码 生成 。 

@ 虚拟 硬件 测试 。 


症 -人 


， 国 基于 模型 的 设计 一 一 MCU 篇 
9.1 传统 设计 的 弊端 


传统 设计 的 工作 流程 如 图 9.1. 1 所 示 。 





{a) 需求 tb) 设计 (c) 实现 (9) 测试 


图 9%.1.1 传统 设计 的 工作 流程 

传统 设计 分 需求 一 设计 一 实现 -测试 4 个 阶段 , 它 的 主要 缺陷 如 下 : 

(1) 这 4 个 阶段 彼此 孤立 ,重复 劳动 严重 。 

《2) 工程 师 们 不 可 避免 地 存在 对 需求 分 析 与 技术 规范 文档 的 理解 差异 , 埋 下 失败 的 伏笔 。 

(3) 在 设计 阶段 需要 打造 硬件 平台 (不 能 保证 满足 技术 规范 的 指标 ) ,前 期 资金 投入 大 。 

(4) 在 实现 阶段 只 能 采用 手工 编程 的 方式 ,人 员 素 质 要 求 高 .难度 大 效率 低 .错误 多 。 

(5) 测试 阶段 只 能 在 完成 原型 样机 之 后 才能 进行 , 查 错 与 修正 的 费用 巨大 ,造成 潜在 的 市 
场 风险 。 

据 相 对 资料 描述 ,超过 50%% 的 错误 是 在 编制 技术 规范 阶段 引入 的 ,而 这 时 能 够 发 现 的 错 
误 仅 有 8%% ,大 部 分 的 错误 需要 等 到 测试 阶段 才能 发 现 , 如 图 9.1.2、 图 9.1.3 所 示 。 
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图 9.1.2 各 开发 阶段 引入 错误 的 比例 





开发 险 自 


图 9.1.3 各 开发 阶段 发 现 错误 的 比例 
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(6) 对 于 大 型 项 目 ,参加 和 人员 多 ,开发 平台 不 统一 ,给 后 期 整合 带 来 麻烦 。 
9.2 ”基于 模型 设计 的 优势 





相对 于 传统 的 设计 模式 ,基于 模型 设计 的 4 个 阶段 相互 联系 (图 9. 1. 1), 它 的 优势 如 下 : 
(1) 在 统一 的 开发 -测试 平台 上 ,让 设计 从 需求 分 析 阶 段 就 开始 验证 与 确认 ,并 做 到 持续 
不 断 地 验证 与 测试 ,让 设计 的 缺陷 暴露 在 开发 的 初级 阶段 。 








0 人 
需求 设计 实现 测试 
连续 的 细 化 及 验证 与 测试 
-二 二 - - -过 -一 十 : - 于 1 -党 -十 
可 执行 、 可 We 代码 自动 生成 测试 与 验证 


跟踪 的 需求 
图 9.2.1 基于 模型 设计 的 工作 流程 


(2) 让 工程 师 把 主要 精力 放 在 算法 和 测试 用 例 的 研究 上 , 骨 人 式 C 代码 的 生成 与 验证 留 
给 计算 机 去 自动 完成 ,自动 生成 代码 。 

据 相 关 资 料 介绍 ,自动 生成 代码 在 某 些 情况 下 已 能 够 到 达 甚 至 超过 于 写 代 码 的 效率 ,如 表 
9.2. 1 和 表 9.2. 2 所 列 。 本 书 第 8 章 的 无 刷 电动 机 控制 (模型 未 经 优化 ) 的 例子 ,模型 自动 生 
成 的 C 代码 已 非常 接近 NXP 提供 的 手写 C 代码 的 水 平 , 编 译 后 生成 的 HEX 文件 大 小 也 相差 
不 大 (图 9.2.2、 图 9.2.3)。 

表 9.2.1 美国 伟 世 通 {Visteon) 公 司 数 据 


手写 代码 自动 代码 生成 手写 代码 


表 9.2.2 美国 GMI(General Motors) 公 司 数 据 
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图 9.2.3 NXP 官方 代码 经 Keil 编译 的 HEX 文件 


(3) 大 大 缩短 开发 周期 与 降低 开发 成 本 。Arthur D. Little 公司 的 调研 项 目 显示 ,使 用 基 
于 模型 的 设计 ,其 开发 成 本 大 大 低 于 传统 的 开发 方式 。 随 着 时 光 的 流逝 ,基于 模型 设计 的 优势 


将 更 加 明显 ,如 图 9. 2.4 所 示 。 


Development Cost: Traditional vs, Model-Based 
开发 成 本 : ”传统 vs, 基于 模型 
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图 9.2.4 开发 成 本 比较 
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9.3 ”基于 模型 设计 的 流程 


满足 DO-178b 航空 电子 规范 的 基于 模型 设计 的 工作 流程 如 图 9. 3. 1 所 示 。 用 户 可 根据 


自己 对 生成 代码 安全 性 的 要 求 , 对 图 9. 3. 1 所 示 的 工作 流程 进行 剪裁 。 





验 证 
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9.3.1 建立 需求 文档 


图 9.3.1 基于 模型 设计 的 工作 流程 


系统 设计 人 员 在 着 手 一 个 项 目前 ,一般 需 要 建立 需求 文档 ,这 是 项 目 管理 和 实现 过 程 中 不 
可 或 缺 的 重要 部 分 。 通 常情 况 下 ,需求 文档 采用 Word、Excel HTML 、DOORs 等 常用 电子 文 


档 格 式 书 写 。 


9.3.2 建立 可 执行 的 技术 规范 


在 基于 模型 设计 流程 中 ,系统 工程 师 会 将 需求 文档 转换 成 基于 Simulink&Stateflow 的 可 
执行 技术 规范 ,以 便 对 技术 规范 的 内 容 进 行 验证 与 确认 ,实现 对 设计 过 程 的 早期 验证 ,这 也 是 
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所 谓 的 系统 模型 。 可 执行 技术 规范 的 建立 为 将 来 的 算法 确定 .系统 设计 等 提供 了 可 靠 的 依据 。 


9.3.3 浮 点 模型 


软件 工程 师 根 据 需求 文档 中 的 算法 要 求 、, 系 统 设 计 方 案 , 对 模型 进行 功能 分 区 ,并 结合 具 
体 硬 件 的 特点 调整 模型 和 算法 ,并 对 调整 后 的 模型 进行 重新 验证 与 确认 ,初步 实现 需求 分 析 的 
要 求 。 


9.3.4 需求 与 模型 间 的 双向 跟踪 


基于 模型 的 设计 是 一 个 连续 不 断 地 测试 与 验证 的 过 程 ,在 设计 的 每 个 过 程 中 都 有 可 能 对 
模型 进行 优化 和 调整 。 这 时 ,需求 和 模型 间 的 双 相 跟踪 就 显得 相当 有 必要 了 , 双 相 跟踪 可 以 确 
保 需 求 与 模型 在 设计 的 各 个 阶段 保持 正确 关联 。 

利用 需求 与 模型 的 双 相 跟踪 ,将 文档 中 的 每 一 条 需求 对 应 一 个 或 多 个 模块 关联 ,同时 将 模 
型 中 的 每 一 个 模块 也 对 应 一 个 或 多 个 需求 关联 。 在 项 目 开 发 过 程 中 ,有 时 候 会 根据 市 场 的 变 
化 增加 或 减少 某 些 功能 (需求 ) , 若 工程 师 发 现 某 些 需求 根本 不 可 达 或 需要 进一步 细 化 ,可 直接 
修改 对 应 的 模块 ,再 通过 需求 一 致 性 检查 来 追踪 这 些 需 求 的 变化 ,只 要 对 这 部 分 设计 作 适 当 的 
修改 即 可 ,而 不 会 影响 到 整个 的 设计 。 同 时 可 以 发 现 缺 失 的 需求 与 兄 余 等 ,及 时 根据 需求 修补 
缺陷 ,规避 项 目 开 发 的 市 场 风险 。 


9.3.5 Model Advisor 检查 


对 前 面 建 立 的 浮 点 模型 ,还 需 进 行 Model Advisor 检查 ,这 在 设计 早期 特别 有 用 。Model 
Advisor 能 识别 模型 中 隐 含 的 问题 ,警告 和 限制 代码 效率 的 部 分 , 找 出 模型 设置 是 否 会 导致 生 
成 代码 的 无 效 或 代码 不 符合 安全 标准 。Model Advisor 可 指导 用 户 修补 生成 代码 的 模型 , 通 
过 分 析 模 型 或 模块 的 配置 ,给 出 模型 组 件 的 检查 结果 并 提供 模型 的 改进 意见 。 


9.3.6 模型 验证 


模型 验证 是 系统 完整 性 需 重点 关注 的 问题 ,在 基于 模型 设计 的 每 一 阶段 都 需 对 系统 的 设 
计 进 行 检查 .分 析 和 测试 工作 , 它 贯 穿 于 项 目 开 发 的 全 过 程 。 一 般 主 要 进行 以 下 几 项 测试 ， 

(1) System Test 系统 测试 。System Test 为 模型 的 测试 提供 了 一 个 软件 框架 ,工程 师 可 
以 利用 System Test 预定 义 的 元 件 创 建 测试 程序 ,并 运行 和 分 析 测 试 MATLAB 代码 或 Simnu- 
link 模型 的 结果 。 利 用 MATLAB 脚本 文件 和 分 析 工 具 对 数据 进行 详细 的 分 析 与 研究 ,保证 
了 项 目 从 研发 到 试 生 产 阶 段 的 测试 过 程 都 是 标准 与 可 重复 的 。 

(2) Simulink Design Verifier 设计 验证 器 。 针 对 Simulink 和 Stateflow 模型 的 验证 ,用户 
可 采用 Simulink Design Verifier 自动 生成 测试 用 例 ,来 满足 模型 覆盖 度 分 析 和 用 户 自 定 义 目 
标的 要 求 , 同 时 Design Verifier 还 可 以 检验 模型 的 属性 以 及 生成 反例 。 用 户 也 可 在 Simulink 
或 Stateflow 模型 中 自 定 义 测试 目标 。 使 用 属性 检验 功能 ,以 寻找 设计 中 的 下 疲 、 完 余 的 状 
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态 .缺失 的 需求 ,这 些 问 题 在 仿真 过 程 中 通常 是 很 难 发 现 的 。 

(3) 覆盖 度 分 析 。 模 型 覆盖 度 是 用 来 评估 模型 测试 用 例 的 累积 结果 ,检验 结果 为 一 百 分 
比 , 它 表 示 以 测试 用 例 作 为 模型 的 输入 信号 ,仿真 结束 后 ,仿真 能 到 达 的 通路 占 所 有 通路 的 百 
分 比 。 模 型 覆盖 度 检 查 记 录 下 模型 中 每 一 个 能 直接 或 间接 决定 仿真 通路 的 模块 的 执行 情况 ， 
同时 也 记录 模型 中 Stateflow 图 表 的 状态 及 状态 转移 情况 。 根 据 模型 覆盖 度 报 告 , 用 户 可 以 
发 现 模型 中 是 否 存在 从 未 被 执行 的 功能 模块 ,判断 是 模块 元 余 还 是 设计 缺陷 。 





9.3.7 定点 模型 


上 述 仿真 .检查 .验证 等 一 系列 过 程 ,已 经 在 一 定 程 度 上 证 明了 浮 点 模型 的 可 行 性 ,下 面 可 
针对 具体 的 符 和 人 式 处 理 器 作 定 点 化 处 理 , 使 模型 和 算法 在 硬件 上 得 到 进一步 优化 ,减少 生成 代 
码 的 长 度 以 提高 代码 效率 ,降低 功 耗 。 

由 于 和 定点 模型 具有 简化 电路 ,缩小 芯片 体积 ,运算 速度 快 , 功 耗 低 的 优势 ,在 基于 模型 设计 
的 开发 过 程 中 ,应 尽量 将 模型 中 的 数据 类 型 作 定 点 化 处 理 。 

用 户 可 以 自己 手动 设置 定点 数据 类 型 ,然后 借助 Fixed-Point Tool 工具 检查 设置 是 否 符 
合 设计 要 求 , 或 者 用 Fixed-Point Advisor 工具 自动 定 标 , 再 借助 Fixed-Point Tool 工具 优 
化 定 标 。 


9.3.8 软件 在 环 测试 (SIL ) 


软件 在 环 测 试 (SIL)? 是 在 模型 环境 中 ,对 模型 自动 生成 的 庶 人 式 C 代码 或 手写 代码 进行 
非 实 时 性 联合 仿真 ,以 评估 这 些 代 码 的 优 劣 ,完成 对 生成 代码 的 早期 验证 。 

软件 在 环 测试 不 需要 硬件 ,只 是 对 算法 代码 进行 测试 ,具体 做 法 是 对 要 进行 测试 的 子 系统 
编译 可 生成 SIL 模块 ,比较 原 模块 与 SIL 模块 的 输出 ,以 此 确认 算法 的 正确 性 。 


9.3.9 处 理 器 在 环 测试 (PIL ) 


处 理 器 在 环 测试 (PIL? 是 将 自动 生成 的 C 代码 下 载 到 处 理 器 中 ,并 和 被 控 对 象 模型 在 模 
型 中 进行 非 实时 仿真 , 即 通过 真实 的 IO ,串口 等 来 交换 工作 在 处 理 器 上 的 嵌入 式 C 代码 和 运 
行 在 模型 中 被 控 对 象 模型 间 的 数据 ,来 评估 代码 在 处 理 器 上 的 运行 过 程 ,以 便 发 现 由 目标 编译 
句 或 处 理 器 产生 的 错误 ,PIL 协同 仿真 可 以 帮助 用 户 估计 算法 的 优 劣 。 通 过 PIL 测试 ,可 以 在 
所 支持 的 处 理 器 上 自动 生成 子 系统 的 代码 ,还 可 以 用 原始 的 Simulink 模型 自动 验证 生成 的 内 
和信 式 代码 ,包括 在 Simulink 中 无 法 仿真 的 一 些 目标 特定 的 代码 。 


9.3.10 代码 与 模型 间 的 双向 跟踪 


需求 与 模型 间 可 建立 双向 跟踪 ,代码 与 模型 同样 也 可 以 建立 这 样 的 跟踪 ,用 户 可 以 通过 代 
码 与 模型 间 的 链接 ,快速 定位 某 个 模块 所 对 应 的 代码 段 ,也 可 以 通过 分 析 代 码 ,改进 模型 。 


27。 
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9.3.11 代码 优化 


为 了 消除 MATLAB 软件 的 一 些 瓶 颈 ,对 代码 模型 须 按 以 下 步骤 进行 修改 : 
(1) 进行 Model Advisor 检查 并 按 其 建议 修正 模型 。 

(2) 进行 DO -178b 航空 电子 规范 检查 (包括 其 他 行业 标准 )( 可 选项 ) 。 

(3) 对 模型 按 功 能 进行 原子 化 处 理 。 

(4) 对 RTWEC 进行 优化 设置 (包括 为 具体 芯片 生成 C 代码 ,这 可 成 倍 提高 代码 效率 ) 。 
(5) 对 生成 的 能 入 式 C 代码 按 传统 方法 进行 优化 。 


9.3. 12 生成 产品 级 代码 


经 过 上 述 一 系列 的 验证 和 优化 ,生成 的 C 代码 可 和 手写 代码 媲美 。 


9.4 需求 分 析 及 跟踪 


9.4.1 系统 模型 


根据 PID 控制 电动 机 这 项 任务 的 要 求 , 模 型 中 需要 以 下 基本 功能 : 
@ 电动 机 控制 信号 输入 。 

@ PID 控制 器 。 

@ 直流 电动 机 模型 。 

@ 转速 监控 。 

按照 这 些 需求 ,建立 需求 文档 ,如 图 9. 4. 1 所 示 。 


电动 机 PiD 控制 系统 需求 ， 


1.Control Signal Input.， 
控制 信号 输入 . 
2. PID Controlier: 
plpD 控制 器 , 
3. DC Motol|， 
直流 电动 机 模型 . 
4. 4 Monitor': 
转速 监控 , 
图 9.4.1 需求 文档 
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根据 上 述 需求 建立 模型 ,这 里 将 使 用 在 第 2 章 建立 的 直流 电动 机 模型 ,如 图 9. 4. 2 所 示 。 


吐 E | 
PiID Controlier 
BC_motor_subsystem 


图 9.4.2 直流 电机 模型 


为 了 使 其 满足 文档 中 的 需求 ,显然 还 需要 做 以 下 修改 : 
(1) 用 图 9. 4. 3 所 示 的 两 个 step 模块 和 add 模块 代替 Signal 
step Builder 模块 作为 速度 控制 信号 (Signal Builder 模块 不 支持 后 续 过 
程 中 的 某 个 步骤 ) ,将 输出 信号 幅度 调整 为 225 ,并 适当 延长 控制 信 
号 的 持续 时 间 ,以 求 尽量 接近 实际 。 
step2 二 其 中 ,stepl 模块 的 阶 竖 时 间 (step time) 设 为 10 s, 信 号 幅度 
(Final Value) 设 置 为 225;step2 模块 的 阶 既 时 间 设 置 为 50 s, 信 和 号 
幅度 设置 为 225 。 
然后 将 这 组 模块 创建 为 一 个 子 系统 ,作为 速度 控制 信号 输入 ,如 图 9. 4.4 所 示 。 


Speed 
















Signal Builder 





Speed Scope 


图 9.4.3 信号 发 生 模 块 组 






Control Signal Input PID Controller 





Scope 






DC_motor_subsystem 


图 9.4.4 更 换 控 制 信号 模块 
修改 后 的 输出 信号 波形 如 图 9. 4. 5 所 示 。 





图 9.4.5 输出 信号 模型 
(2) 将 Sum 和 PID 模块 创建 为 一 个 子 系统 ,对 应 需求 中 的 PID 控制 器 ,如 图 9. 4.6 所 示 。 





Control Signal Input 






PiD Controller 






DC_maotor_subsystem 


图 9.4.6 创建 PID 子 系统 
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(3) 修改 DC_motor_subsystem 子 系统 , 删 去 转 矩 和 角度 输出 , 仅 关 心 其 转速 值 , 对 应 需 
求 中 的 直流 电动 机 模型 ,将 电动 机 参数 调整 为 玉 一 2, 了 一 0, 1] ,天 。 一 0. 1 ,天 :一 0. 1， 开 or 一 0. 1 ， 
J 王 0.1。 子 系统 修改 后 如 图 9. 4.7 所 示 。 


-一 一 一 一 -， -一 -一 -一 一 -一 -一 一 -一 一 一 一 一 一 -一 -- 一 





Cain5s 
图 9.4.7 ”DC_motor_subsystem 子 系统 
(4) 完成 第 三 步 后 ,将 示波器 由 3 通道 改 为 2 通道 。 电 动机 模型 仅 余 一 个 输出 口 (电动 机 
转速 ) ,将 其 与 Control Signal Input 信和 号 通过 合 路 器 Mux 模块 一 并 连接 到 示波器 上 ,以 监视 


其 响应 ,对 应 于 需求 中 的 转速 监控 。 同 时 ,可 以 将 速度 控制 信号 和 PID 输出 信号 也 连接 到 示 
波 占 上 ,方便 分 析 三 者 间 的 关系 ,如 图 9. 4.8 所 示 。 







PID Controller Output 


Actual Speed 






control Signal Input 


PID Coniroller DC_moltor_sUpsystemn 四 _ 
Speed Control Signal 


图 9.4.8 功能 验证 模型 
考虑 到 最 后 的 能 人 式 实 现 , 将 PID 模块 的 算法 修改 为 PI, 然 后 按照 第 2 章 介绍 的 方法 调 
整 其 P,.I 参 数 ,得 到 合适 的 值 。 可 以 看 到 电动 机 实际 转速 的 响应 曲线 (A) 和 控制 信号 拟 合 度 
较 好 ,PID Controller 模块 的 输出 范围 为 一 700 一 十 1150 ,如 图 9. 4. 9 所 示 。 





图 9.4.9 仿真 波形 
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9.4.2 需求 关联 


1. 注册 控件 


在 建立 需求 到 模块 的 关联 之 前 ,需要 首先 注册 ActiveX 控件 ,以 便 在 需求 文档 (以 word 
为 例 ) 里 加 入 模块 导航 按钮 。 过 程 如 下 : 


>> rmi Setup 


Registered the requlirements RMctive-X controlSs 
>> 


2. 关联 选项 


选择 模型 窗口 的 菜单 项 Tools ~ Requirements -~ Setting. .. ,打开 需求 设置 选项 。 
Report 页 ,用 户 可 以 设置 需求 报告 所 包含 的 内 容 。 如 表 9. 4. 1 所 列 。 
表 9.4.1 报告 选项 


在 生成 报告 前 ,高 亮 显示 已 关联 需求 的 Simulink 模块 ,并 在 
Highlight the model before generating report 


体现 在 生成 的 报告 里 
Report objects with no links to requlrements 列 出 未 关联 到 需求 的 Simulink 模块 
Show User tags for each reported links 在 每 项 报告 链接 中 显示 用 户 标签 
. ， ， 如 果 需 求 文档 的 ID 可 用 , 则 显示 在 报告 需求 表格 的 ID 栏 
Use document index in requirements tables where possible _ 
显示 为 代替 文档 路 径 
Include links to object 含有 至 目标 的 链接 


在 Selection-Based Linking 界面 中 ,用 户 可 以 设置 需求 关联 形式 文档 位 置 等 ,这 里 仅 简 
要 说 明 各 个 选项 的 意义 ,使 用 技巧 用 户 需要 自行 体会 。 初 期 建议 将 模型 与 需求 文档 放 在 同一 
个 目录 ,并 按 图 9. 4. 10 进行 设置 Selection-Based Linking 界面 。 熟 练 掌握 后 , 则 可 按 项 目 管 
理 的 要 求 ,修改 Selection-Based Linking 界面 设置 ,并 安排 需求 文档 及 模型 的 正确 位 置 。 
| Report Selection Lirking Filters 
| Lirnking to the actliVe selection within ar external docunment 


Enabled appllcat1lons: yi Word YI| Excel 


| Document file reference; path relatliVve to model folder 囊 | 





| When creating selection-based links 
Vi Modify docunments to include links to models (two-way linking) 
Kodel referernce: | mone (om 了 ATLAB path) 二 | 


TUse custom Iicor: 


| Appl7y this user tag to mew links: 严 


图 9. 4. 10 ” Selection-Based Linking 界面 设置 
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表 9.4.2 设置 项 含义 


在 将 模块 关联 到 需求 文字 时 ,选择 可 用 的 链接 类 型 


Enabled Applications 如 图 9. 4. 10 选中 Word 与 Excel, 右 击 模块 的 Requirerment 菜单 ,会 出 现 两 
个 选项 Add link to Word selection Add link to active Excel cell 
指定 需求 文档 的 位 置 
* absolute path: 绝 对 路 径 
Document file reference *， path relative to _ current directory: 当前 目录 


。 path relative to model directory :模型 存放 的 目录 
*， filename only (on MATLAB path) ; 仅 文 件 名 


使 能 该 选项 , 当 完 成 需求 关联 后 ,在 对 应 的 需求 文字 后 加 入 导航 按钮 ， 
默认 以 书签 形式 捅 人 

指定 从 需求 文档 寻找 关联 模型 的 路 径 
Model reference * absolute: 绝 对 路 径 
*。hnone (on MATLAB path) :相对 路 径 


Modify docurments to include links to models 


3. 建立 关联 


本 文 以 Microsoft Word 作为 文档 编辑 环境 ,建立 图 9. 4. 1 所 示 的 需求 文档 ,由 于 目前 
MATLAB 诸多 组 件 不 支持 中 文 , 因 此 需要 关联 到 模块 的 需求 主题 词 ,必须 以 英文 表述 。 

建立 关联 的 步骤 如 下 : 

(1) 在 需求 文档 中 ,选中 需要 建立 关联 的 主题 词 * 例 如 选中 1. Control Signal Input。 

(2) 右 击 需要 建立 关联 的 模块 ,如 Control Signal Input 子 系统 模块 ,选择 菜单 项 Tools 一 
Requirements 一 Add link to Word selection ,如 图 9. 4. 11 所 示 。 


Reaquirements 上 Add link to Word selecthion | 
Design Verifer 上 dd link to acve Excel cell 
Real-Time Workshop Edk/Add Unikcs .. 

HDL Coder Smfnos 
PLC Coder # poemseremroerrreeoreeeenomereeenergempeg 


图 9.4.11 建立 关联 


aa (3) 这 时 需求 主题 词 的 未 尾 ,加 入 了 一 个 导航 接 
ee 改 、 但 ,如 图 9.4 12 所 示 。 其 他 需求 可 按 回 样 方法 与 模 

块 相关 联 。 
RE (4) 再 次 右 击 先前 的 模块 ,选择 菜单 项 Tools -> 
Requirements 一 1.， Control Signal Input, 则 对 应 的 

需求 主题 词 高 亮 显示 ,如 图 9. 4. 13、 图 9. 4. 14 所 示 。 


Requirerments 上 1. "Control Signal jnput” | 


Design Verifier addiinkto Word selection | 
Real-Time Workshop Add iink to active Excel cell PP 
HDL Coder EdtAdd Unks .- 
PLC Coder Deiete AI Linkes .. | 
Fxed-Point 


Settings 


图 9.4.13 ”模块 关联 的 需求 文档 
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电动 机 PID 控制 系统 需求 


3. DC Motor 列 
直流 电机 模型 . 

和 .Mionitor 到 
转速 监控 , 





图 9.4.14 关联 模块 高 亮 
(5) 双击 需求 主题 词 末尾 的 导航 按钮 ,对 应 的 模块 高 亮 显示 ,说明 需求 与 模块 之 间 已 建立 


了 关联 ,如 图 9.4. 15 所 示 。 
电动 机 plD 控制 系统 需求 


1. Control Signal input 友 - 

控制 信号 输入 . 

2. PID Contreller 副 - 

pip 控制 二 人 
3. DC Motor 别 : 

直流 电动 机 横 型， 


4. Monltor 副 . 
转速 监控 





图 9%.4.15 文档 关联 到 模型 


9. 4.3 ”一致 性 检查 


1. 完成 文档 与 模型 间 的 关联 后 ,可 立即 进行 一 致 性 检查 


(1) 选择 模型 窗口 菜单 项 Tools 一 Requirements 一 Consistency checking. . . ,系统 打开 
Meodel Advisor 界面 ,如 图 9. 4. 16 所 示 ,并 自动 选中 Requirements consistency checking 子 类 。 


Report name: 下 odel Advisor -- Requirement consistency checking 


Simmulink version: 7 了 .6 iodel version: 1.19 
System: DC_EKOTOR_mbd Current Tun: 07-0ct-2010 22:01:18 
Run Summary 
可 Pass 人 Fail 玫 Warning 辽 Not Run Total 

人 4 @0 全 0 司 0 4 


图 9.4.16 Model Advisor 界面 


《2) 关闭 Word 应 用 程序 ,再 单 击 右 侧 的 Run Selected Check 按钮 ,开始 检查 。 
(3) 检查 完成 ,报告 显示 通过 一 致 性 检查 。 
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2。 需求 变更 
(1) 若 增加 了 某 项 需求 ,用 户 只 要 查看 文档 是 否 存 在 尚未 关联 的 需求 主题 词 , 即 可 判断 是 
否 增加 了 需求 。 


(2) 若 某 项 需求 被 修改 了 ,例如 ,将 文档 中 的 1. Control Signal Input 修改 为 1. Control Signal ,一 
致 性 检查 报告 显示 模块 原先 关联 的 文字 与 当前 文档 中 的 需求 主体 词 不 一 致 ,如 图 9. 4. 17 所 示 。 


及 Identify selection-based links having description fields that do not match their 
Tequireaents document text 


Inconsistemncies: 


The following sclection~based links have descriptions that 下 ffer 和 om their 
corresponding selections in the requirements documents。 If this reflects a change in 
the requirements document，click Update to replace the current description in the 
selection-based link with the text from the requirements document (the erternal 


description). 
Block Current Exzternal 
description decscription 
DC_OTIOR_mbdAEontral Signal Control Signal 
Tut Tt Control Signal Update 


图 9.4.17 ”模块 原先 关联 的 文字 与 当前 文档 中 的 需求 主体 词 不 一 致 警告 


单 击 报告 右 下 角 的 Update 链接 ,可 将 模块 原先 关联 的 文字 用 更 新 后 的 需求 主题 词 代 替 。 
再 次 执行 该 项 检查 , 即 显 示 通 过 。 

(3) 若 某 项 需求 被 删除 ,例如 删 去 1. Control Signal Input, 一 致 性 检查 报告 显示 无 法 定位 
到 先前 关联 的 需求 主体 词 ,如 图 9. 4. 18 所 示 。 


洗 Identify requirement links that specify invalid locations within documpents 
Inconsistencies : 


The following requirements link to invalid locations within their documents。 The 
specified location (e.g.，bookmark，1ine number，anchor) within the requirements 
document could not be found To resolve this issue，edit each requirement and 
specify a valid location within its requirements document. 


Bl1ock Recquirecmeents 
DC _NOTO Control Signal Input Control Signal Input 


9.4.18 无 法 定位 到 先前 关联 的 需求 主体 词 警告 
单 击 报告 左下 角 的 链接 DC_MOTOR _mbd/Control Signal Input, 可 定位 到 对 应 模块 , 单 
击 右 下 角 的 链接 Control Signal Input, 可 打开 该 模块 的 需求 编辑 窗口 。 用 户 可 根据 需要 删除 
模块 或 重新 关联 需求 。 
3. 模块 变更 


(1) 在 后 续 的 仿真 过 程 中 , 若 需 要 新 增 模 块 ,用 户 需 自行 将 新 模块 关联 到 对 应 的 需求 主题 
词 。 例 如 ,在 模型 中 添加 一 个 Constant 模块 ,在 模型 窗口 中 选择 菜单 项 Tools -> Require- 
ments 一 Generate report, 在 设置 了 Report objects with no links to requirements 选项 的 前 提 
下 ,如 果 模 型 存在 未 关联 到 需求 的 模块 ,报告 会 列 出 相应 的 模块 ,如 图 9. 4. 19 所 示 。 
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Table 3.2. Objects in "DC_MOTOR_mbd" that are notlinked to requirements 


=-~~-- 一 ~- 一 一 


Name Type 
Constant Constant 


图 9.4.19 未 关联 的 模块 
另外 ,选择 菜单 项 Tool 一 Requirements ~ Highlight model, 关 联 了 需求 的 模块 会 被 高 
亮 显示 ,由 此 可 作 快 速 分 辨 ,如 图 9.4. 20 所 示 。 


PID COontroller OUtpuf 





Actual Speed 


Speed Control Signal 


图 9.4.20 关联 模块 高 亮 
(2) 若 用 户 径 自 删 除了 模型 里 的 某 个 模块 ,用 户 可 逐一 单 击 需求 导航 按钮 来 确定 某 个 主 
题词 已 无 对 应 的 模块 。 当 然 恰 当 的 办 法 是 在 删除 模块 前 , 先 链接 到 需求 文档 ,修改 文档 后 再 修 
改 模型 。 


9.5 模型 检查 及 验证 


9.S$.1 System Test 


SystemTest 为 用 户 提供 了 一 个 框架 ,在 同一 个 环境 下 可 以 集成 软件 .硬件 .仿真 以 及 其 他 
类 型 的 测试 。 用 户 使 用 预定 义 的 元 素 ,方便 快捷 地 创建 并 维护 测试 程序 ,之 后 保存 并 共享 它 
们 ,这样 在 整个 开发 过 程 可 重用 这 些 测试 程序 ,保证 了 测试 是 标准 的 。 

SystemTest 软件 集成 了 数据 管理 与 分 析 功 能 ,能 够 保存 测试 结果 ,实现 了 基于 模型 设计 
所 要 求 的 一 一 连续 不 断 的 测试 。 

SystemTest 特点 ,如 表 9. 5. 1 所 列 。 

表 9.5$.1 SystemTest 特点 


类 型 特 点 
图 形 化 环境 用 户 可 以 使 用 图 形 化 测试 开发 环境 ,快速 建立 测试 程序 
可 重 现 的 测试 ”| 所 有 使 用 SystemTest 开发 的 测试 程序 , 均 可 共享 使 用 
参数 测试 建立 参数 测试 向 是 ,可 对 模型 进行 选 代 测试 
可 维护 性 因为 开发 调试 程序 使 用 的 是 图 形 化 的 界面 ,因此 用 户 不 需要 了 解 复杂 的 代码 ,快速 修改 这 些 程序 


"435。 
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(1) 模型 调整 。 根 据 本 例 的 特点 ,选择 电动 机 模型 中 的 参数 K'( 即 摩擦 因数 ) 与 电动 机 模 
型 的 响应 曲线 作为 测试 对 象 ,将 电动 机 实际 转速 信号 保存 到 工作 空间 ,模型 调 按 图 9. 5. 1 
调整 。 





Control Signal Input 


图 9.5.1 调整 模型 
增加 了 To Workspace 模块 ,该 模块 设置 如 图 9. 5. 2 所 示 。 


ParametsrS 


Variable mame: 

Response 

Lialit data points tO 1ast: 
LE 


Declmation: 


1 
Sanmple tine (-1 for inherited); 
Er 


5ave format; [Array Re Eee ] 


Log fixed-point data as am fi Dbject 


图 9.5$.2 To Workspace 模块 设置 


(2) 建立 测试 程序 。 在 MATLAB 命令 行 窗口 输入 systemtest, 打 开 SystemTest 界面 如 图 9. 5.3 
所 示 。 


同 e。 Ed jnsert Run Tools Desldop Window Hetp 


林村 太 习 | 曙 Ron 李 Sop 已 | 
[| 


| “This Test Payses 疼 | 
刘 人 imia check elements in an iteration pas5 
， Any imit check elerment in an ieration Passes 
和 AND 


| 章 AI| Nteraticons Pass 
站 有 


mm 


Amy fteratiOn Pas505 


Descripbon 





图 9.5.3 SystemTest 界面 
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(3) 添加 测试 模型 。 选 择 SystemTest 菜单 项 ,Insert 一 Test Element 一 Simulink, 如 图 9. 5. 4 
所 示 。 





- RAR ap 二 
File Ed | nsenj Run Toocls Desktop Window Help 











Instrument Control 






了 5 困 Te 弥 Elernent 上 正 
Test Browwsi Test Vector Limit Check 
New~- 看 Test Variable,.. MATLAB 
总 uted 
_ Untid Resource blot - General 
pore 
本 Main Tekt SEE 

Save Resulits n an iter 
| Post Test Subsecbon 
| ， 园 Test Vectors Data 六 cquisition 
| 田 Test Variables Image Acquisition ， 
| 


下 Amy Kerabon Pass5e5 


图 9.5.4 添加 测试 模型 


在 Simulink model 文本 框 里 输入 待 测试 的 模型 路 径 ,或 单 击 右 侧 的 Browse. . . 按钮 ,指定 
模型 路 径 ,如 图 9. 5. 5 所 示 。 


Pie Edn 1nser Run Tocls Deskaop Window Heip 
] 天 ;四 人 Ron 基 PRop 全 
》 外 全 


ev 





Mappings Medel Coverage 





Terriae Thgort 二 eck 忆 tpals rtth SystesTest Dats 


erriis 机 sthk Piresetwrs wii 必 steeloet aots 人 
RD 本 二 
Smulink Da SystemTest Data 

图 9.5.5 指定 模型 路 径 


(4) 添加 测试 参数 向 量 。 在 中 间 界 面 的 Mappings, 展 开 第 二 设置 项 Override Block Pa- 
rameters with System Test Data ,增加 一 个 新 的 参数 映射 ,选择 Select Block to Add. . .选项 ， 
如 图 9. 5.6 所 示 。 





r-- 一 一 ---- 


Fie Edit jnsert Ron Tools Desktop Window Help 
了 妇 辐 宁 人 | 和 Run 业 Sce 






| 
| 
| 
| 
| 
f 


| 
| 加 Test Vectors 
田 Test Variables 





引 ock 'To Workspace' Paran 





图 9.5.6 增加 参数 映射 


在 随后 打开 的 模型 窗口 单 击 To Workspace 模块 ,之 后 返回 System Test 主 窗 口 。 
在 新 增 的 参数 映射 栏 Simulink Data 列表 ,选择 DC_motor_subsystem : Viscous Friction 
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Constant 选项 ,在 SystemTest Data 列表 中 ,选择 New Test Vector. . . 选项 ,如 几 9. 5. 7 所 示 。 


Simulnk model 
D:VMATLAS FLES\DC moteDC_ MOTOR mbdmd| 
DC MOTOR mbda 


Mapping5 Medel Coverage 


Dvarride Import 了 Lock Signas with SystemIest Data 


二 1 byerrids Block Paranaters 叶 th SystesteE Datas 人 
New Mappine* 会 如 和 


SysterTest Data 


New Test Vector :> 





图 9.5.7 新 增 测试 向 量 


在 随后 打开 的 Insert Test Vector 对 话 框 里 ,为 向 量 命 名 ,如 Kf; 并 为 其 指定 取 值 范围 ,如 
[0 :0.1:1], 如 图 9.5.8 所 示 。 


Select Test Vector tyPe' 


MAT-File Name: tf 


Seneral | Grouping 


Probabilty Distrbution 
w Type; 
Signal Builder 5lcck 


Simujink Design Verifer Da,， 


Expression: fd410 


Spreadshest Data 





Test Ca5se Data 
Test Vector 5uUccessfully evaluated to 3 lxli0 double 


Exaluats Test Vector each time the teSi5 fu 


9.5.8 测试 向 量 命名 


(5) 添加 输出 变量 。 在 中 间 页 面 的 Mappings 列表 中 ,展开 第 5 设置 项 Assign Model 
Outputs to SystemTest Data ,增加 一 个 新 的 输出 信号 映射 ,选择 To Workspace Block 选项 ,如 
图 9. 5. 9 所 示 。 

在 新 增 的 输出 映射 栏 Smulink Data 列表 中 ,选择 To Workspace 选项 ,此 即 对 应 着 模型 里 的 
Tb Workspace 模块 ;在 SystemTest Data 列表 中 ,选择 New Test Variable. . . 选项 ,如 图 9. 5. 10 
所 示 。 

在 随后 打开 的 Edit Tb Workspace 对 话 框 里 ,为 变量 命名 ,例如 Tb Workspace, 如 图 9. 5. 11 
所 示 。 
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Semnuknk mcdol 

DAWMATLAS FLESDC_mosoDC_ MOTOR mpbdmdl 

DC_MOTOR_mbd 

Mappings | Model Coverage 
本 


3 


te 
二 本 人 和 ae 这 二 9 

New Mapping- ;二 要 ;和 

Logged 9gnal Simuiink Data 

Ouwper Si9nal 


SystemTest Deata 





图 9.5.9 增加 输出 信号 映射 
New Mapping * | 合 量 | Mappings Assistant 
| Mapping Type Simulink Data 


区 





SystemTest Data 
Te Workspace Block | To Workspace 


<New Test Variablis ,> 





图 9.5.10 新 增 测试 变量 









Edit ToWeorkspace 


| 
Narne 
ToWiorkspace 
Initial value (optional) 
| 


Assigned in 


| 
Main Te 





图 9.s$.11 变量 命名 
(6) 添加 绘图 测试 。 本 测试 的 目的 是 为 了 得 到 不 同 参 数 条 件 下 的 系统 响应 ,添加 绘图 测 
试 元 素 后 可 直观 地 显示 响应 曲线 。 


选择 SystemTest 菜单 项 ,Insert 一 Test Element 一 Plotr-General, 如 图 9. 5. 12 所 示 。 
单 击 add plot 按钮 在 下 拉 菜 单 中 选择 plot 选项 ,添加 绘图 类 型 ,如 图 9. 5. 13 所 示 。 


ss 
439 。 间 
和 和 

昌 刘 
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Tegt Vectors 





Fle Edk [set] Run Tooks Deskop window Hp 


台电 Test Element 上 下 
Test Byrowx4 Test Vector 


New~ 者 Test Variabije MATLAE 2 ER 
ae aa 
1 Pre Te6 广 汗 ss EROER 2 
是 | Stop 
















并 





| 习 
Subsection 
Data Acaquisiton + 
[Te image Acquisiion ， Te Werkspace 
| jnstrument Controcl * 


| Me Simulink Data 


器 Meore plots 





propernes 


FISure narme': 







ToWorkspace 





图 9.5.12 添加 绘图 测试 图 9.5.13 添加 plot 绘图 类 型 


添加 plot 绘图 类 型 后 ,在 Y Data Source 列表 框 中 选择 To Workspace 选项 ,作为 图 形 的 
纵 坐 标 参 数 , 如 图 9. 5. 14 所 示 。 


「 Genera Opuions 
Add anes i hddplet ) 久 Delete 
-Figure 


*，TGNWerkspeca)} 


X Data Sourcer <Awuto> 四 
Optional 


YiData Seurce ToWorispaece 皇 





图 9.5.14 指定 纵 坐 标 数 据 
在 Options 选项 卡 中 ,选择 keep any existing data on the figure 选项 ,如 图 9. 5. 15 所 示 。 


Test Variabjes 
En Optbons 
Each time the element executes 


个 Clear the figure of any previous iteration's data 


| 加 Keep any existing data on the figure 


玉 this test is generating a report 


8 Put a snapshot of the fgure into the report each iteration 
Put as snapshot of the figure imto the report at the end of the test 


Do not put any snapshots into the report 





图 9.5.15 Options 选项 卡 
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(7) 添加 输出 结果 。 选 中 System Test 主 窗口 的 左 侧 窗口 的 Save Results 选项 ,在 中 间 窗 
口 单 击 New Mapping 按钮 ,新 增 输 出 结果 映射 ,如 图 9. 5. 16 所 示 。 


| Pie Edit Insert Run Tools Desktop Window Help 


有 当 | 只 CC ) 共 )Roun 于 4 
rcwwser 机 ” 藉 Vector 
| 二 |; > | IMap Test Variables 4o Results 
7 test | Specify the test variables you want to save at the end of each Main Test iterabcn 
Pre Test | test Variable to a test resu narme， 
Main Test (1Ll Iterationg) 
是 | Simulink Note, test vectcrs do not need to be 5Specfied. By defau 愉 they are mmade availab 
下 | test results 
PI | New Mapping9 好 
疝 | Test Vectors | | Test Variable Resu 人 t 
多 和 | 


TewWiorkspace 





图 9.5.16 添加 输出 结果 
根据 需要 ,选择 输出 结果 To Workspace, 并 取 名 为 To Workspace, 如 图 9. 5. 17 所 示 。 


Map Test Variables to Resuits 
Specify the test variables you want to 5ave Bt the end of each Main Test ieraticn by mapping 


test variable to a test result name 


Necte test vectors do not need to be 5pecifed, 5y defaulkt they are made available with 5aved 
test results. 


New Mapping ; 合 各， 六 





图 9.5.17 选择 输出 结果 


(8) 执行 测试 并 观察 结果 。 保 存 测试 程序 ,并 单 击 菜单 栏 的 Run 按钮 ,开始 测试 系统 ,如 
图 9.5.18 所 示 。 


esi Desktop 区 Indow Help 


Sop ， 碗 








图 9.5.18 执行 测试 
SystemTest 主 窗口 右 侧 界面 的 Run States 下 部 显示 当前 的 迭代 次 数 . 测 试 时 间 , 如 图 9.5. 19 
所 示 。 


Test Status: iteration 8 
Time Elapsed: 00:00:01 


~ 


图 9.5.19 测试 进度 


本 基于 模型 的 设计 一 MCU 篇 


完成 后 Run States 界面 给 出 测试 结果 文件 链接 与 最 终 测试 状态 ,本 测试 程序 成 功 运行 ， 
如 图 9. 5. 20 所 示 。 


| Generated Files 
The 估 llaowinog 们 2S Were genarated in DYMATLAB FILESIDC_motar 





Open Fenarme 
| 
| TestResults outputsWest results.mat 
| 
| Final Test Statis 
Property Value 
StartTime 19-Oct2010 11:14:42 
| StopTime 19-0ct2010 11:14:44 
| lterations Completed ”11 
Final Status Completed Successfully 
Test Status: Completed Successfully 





Time Elapsed: “0000:02 


图 9.5.20 测试 完成 


单 击 测试 结果 文件 链接 Test Results, 在 MATLAB 命令 行 窗口 显示 测试 结果 的 详细 信 
息 ,如 图 9.5. 21 所 示 。 


Loading test resultSs.... 
StresultS = 


Test Results Object Summary for“test”: 
了 ImberOfIterations: 11 
TeStVectOIKameSs: Xf 
SavedResultNamesS: 
ResultsDataSet: [11xl dataset] 


TIhere are no TIest Vector GroupS asSoclated Yith thlSs test reSult ob]Ject. 


Artifacts asSSociated with thas test restlt object: 
TE5I-File !{test.test)} 


Type stresults,ResultsDataset to disp1lay test reSsUlts data，Fo7 InforRatIoTL 
on WOIKiIng vith test results data，Iefer to the Analyzing TIest ReSsults demo， 


图 9.S$.21 测试 结果 信息 
单 击 链接 stresults. ResultsDataSet ,MATLAB 命令 行 窗 口 继续 显示 


ans = 
KE ToWorkspace 
I [ 0] [1524xl double 
I2 [o.1000] [1523xl double] 
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I3 [0.2000] [1523xl doublej] 
TI4 [0.3000]j [1522xl double] 
I5 「0.4000] [1522xl double] 
I6 [0.5000 [1522xl double] 
I7 [0.6000] [1520xl double] 
I8 [0.7000] [1520xl doublej] 
I9 [0.8000] [1520xl double] 
I10 [0.9000] [1520xl double] 
I11 「 1] [1520xl double] 


>>> 


在 plot 区 域 中 显示 了 取 每 个 参数 时 ,系统 的 响应 曲线 ,如 图 9. 5. 22 所 示 。 其 中 纵 坐 标 为 
信号 幅度 。 横 坐标 为 系统 计算 仿真 时 的 采样 序号 ,而 不 是 时 间 ,这 是 由 于 模型 采用 的 是 变 步 长 
求解 器 ,每 个 采样 点 的 间隔 会 有 变化 ,不 过 每 个 采样 点 和 相应 的 仿真 时 间 点 是 一 一 对 应 的 。 这 
样 就 可 以 将 该 横 坐 标 等 效 为 时 间 坐 标 。 





图 9.5.22 系统 响应 曲线 


分 析 测 试 结 果 可 知 , 电 动机 模型 中 的 每 个 参数 对 整个 系统 的 响应 都 有 较 大 的 影响 ,因此 在 
对 电动 机 建 模 时 ,应 准确 测试 实际 电动 机 的 各 项 参数 ,否则 用 误差 较 大 的 参数 得 出 的 模型 设计 
PID 算法 必定 难以 得 到 理想 的 效果 。 


9.5S.2 Design Verifier 


使 用 Design Verifier 自动 生成 的 测试 用 例 ,可 达到 满意 的 模型 覆盖 度 以 及 用 户 自 定义 的 
. 目标 ,同时 Design Verifier 还 可 以 验证 模型 的 属性 以 及 生成 反例 。 

它 支 持 以 下 几 种 模型 覆盖 度 目标 :分 支 覆 盖 度 (decision) .条 件 覆 盖 度 (condition)、 变 更 条 
件 / 分 支 覆 盖 度 (MC/VDC) 。 当 然 用 户 也 可 以 使 用 design verification 模块 ,在 Simulink 或 
Stateflow 模型 里 自 定义 测试 目标 。 使 用 属性 验证 功能 ,用 户 可 以 发 现 设 计 的 缺陷 .遗漏 的 需 
求 . 多 余 的 状态 ,这 些 问题 在 仿真 过 程 中 通常 是 很 难 发 现 的 。 
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在 PID 控制 直流 电动 机 模型 中 ,实现 控制 功能 的 部 分 只 有 PID Controjler 子 系统 ,最终 应 
用 到 敌人 式 控 制 系统 的 代码 也 是 由 这 部 分 模块 生成 。 而 电动 机 模型 是 为 了 模拟 实际 电动 机 的 
响应 ,因此 ,本 节 仅 对 PID Controller 做 Design Verifier 测试 用 例 分 析 。 

在 模型 中 仅 保 留 PID Controller 子 系统 ,并 为 其 添加 输入 .输出 模块 ,如 图 9. 5. 23 所 示 。 





PID Controller 


图 9.5.23  PID Controller 子 系 统 


在 PID 模块 设置 中 的 PID Advanced 选项 卡 中 勾 选 Limit Outpnut 复 选 框 ,设置 输出 饱和 。 
根据 PID Controller 的 输出 ,可 将 上 下 限 分 别 设 为 1150 和 一 700, 如 图 9. 5. 24 所 示 。 


PID advanced 


Output saturat1Ior 


Jaln 


yi Limit output 

Upper satturationm 1Imit: 
1150 

| Lower saturation limit: 


-TD0 


Data TIypes | 


State Attributes 


图 9.5.24 PID Advanced 选项 卡 


1. 兼容 性 检查 


尽管 Smujink Design Verifier 支持 许多 Samujlink 与 Stateflow 特性 ,但 仍 有 一 些 是 不 支持 的 ,为 
此 用 户 需要 事先 检查 模型 的 兼容 性 。 单 击 模型 菜单 项 Tbols 一 Design Verifier -~ Check Model 
Compatibility, 检 查 模 型 是 否 与 Smulink Design Verifier 兼容 ,如 图 9. 5. 25 所 示 。 


[ecis Help 
Simulink Debugger.， 
Model Adwvisor 
Model Dependencies 
Fixvesd-point 
Loockup Tabjle Editcr,.， 
Data [Cjas5 Designer,.， 
Bus Editor. 


Proler 


Coverage Settin95 


Requirements 


Design Verifier 


inspect Logged Signals.， 
Signal 及 Scope Manager,- 


Real-Time Workshop 


图 9. 5. 25 


办 岗 罩 作 二 只 攻 国电 


+》 | 





PID Controlier 


上 


+ Check Model Compatibility 


Generate Tests 


Prove Properties 


Options ..， 


兼容 性 检查 
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由 于 Design Verifier 仅 支 持 定 步 长 求解 器 ,在 日 志 中 会 提示 不 兼容 的 错误 ,如 图 9. 5. 26 所 示 。 


吕 Simulink Design Verifier log: DC_MOTOR_mbd_design_ver,， 









Checking conmpat1iblility of model 
“DC_JJOTOR_mbd_desigrn_ vetifier” 
"DC_JDOTOR_mbd_design_verifier” is imcomnpatible with 
3Simulink Design Veriflier。 


08-0Oct-2010 13:02:06 


Saxve Log ] Close 


图 9.5.26 不 兼容 错误 
选择 菜单 栏 simulation-~>Configuration Parameters ,在 solver options 界面 选择 定 步 长 求 
解 句 ,如 图 9. 5.27 所 示 。 


Solver opt1ons 








| Solver; | discrete (no cont irmlous States) | 


Fixed-step size (fundamertal sanmple tiae): auto 


Type: |Fixed-step 





图 9.5.27 求解 器 设置 
这 时 在 执行 兼容 性 检查 , 则 显示 通过 ,如 图 9. 5. 28 所 示 。 


最 Simulink Design Verifier |og; DC_MoTOR_mbd_design_ ve_. 攻 区 坷 
人 | 
| 


08-0ct-2010 13;06:40 











| 1 
| 1 
| ， 


Checkaing compat1libllity of model1 | | 
“DC_JOTOR_mbd_design_verifier” | | 

| Conpiling model..。 done 

| Checking compatibility,.，done 

| “DC_MOTOR_nmbd_design_verifier” is conmpatibIe with 

| Simulink Design Verifier， 


[save log [cs ] 








图 9.5.28 通过 兼容 性 测试 


2. 设置 Design Verifier 选项 


单 击 模型 菜单 项 Tools 一 Design Verifier ~ Options. .. ,模型 参数 配置 窗口 下 部 显示 
Design Verifier 设置 选项 ,如 图 9. 5. 29 所 示 。 
二 -Design Werifier 
r-Block Replacements 


Parameters 
Test Generation 


图 9. 5. 29 Design Verifier 设置 选项 
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表 9.$.2 Design Verifier 设置 项 意义 


选项 卡 用 途 
Design Verifier 指定 Design Verifier 的 分 析 类 型 .时间 .输出 目录 等 
Block Replacements 指定 用 于 模型 预 处 理 的 模块 替换 规则 
Parameters 指定 参数 设置 
Test Generation 指定 调试 用 例 的 生成 类 型 
Property Proving 指定 属性 验证 的 选项 
Results 指定 输出 的 数据 文件 .测试 用 例 模型 .System Test 测试 程序 的 生成 选项 
Report 指定 测试 报告 的 生成 选项 


本 例 在 Test Generation 选项 卡 界面 设置 Test suite optimization 项 目 为 LongTestcases， 
这 样 模型 的 各 种 条 件 可 在 同一 个 测试 用 例 里 得 到 满足 ,便于 模型 与 测试 用 例 对 照 分 析 , 如 
图 9. 5. 30 所 示 。 


Tesgt gerneratIor 





Nodel covwetage 0bjectives: | 了 有 DC 四 
Test conditions: Uze local settimgz ~ 
Test ob]jaectzivesi Use local settings 
Jiaxinmum test Ca5e Steps; 500 





Test Suite Opt2RIZat1OTI 


图 9.$. 30 ”Test Generation 选项 卡 
3. 生成 测试 用 例 
单 击 模型 菜单 项 Tools 一 Design Verifier 一 Generate Tests, 系 统 自 动 生 成 测试 用 例 ,如 
9. 5. 31 所 示 。 


progess HREFRREEEREIRS 
Dbjectves Processed 44 

Satusfjed 了 

Falsifed 0 

日 apsed fme 0:01 


Starting test generation foc model moda_Desgnwerifer 网 
Compang model,,, done 

Tansliating model... done 

model_Designverifier 5 compatible with Smulirk Design Verifier. 


Generabng t 记 St5. .， 
SATISFIED 
Erroraturaton 
input >= UPPer jnit 和 
SATISFIED 
Error 和 aturation 
input > jower lprit 上 上 
SATISFIED 
Erroraturation 
input > IOowWer jnet 了 
SATISFIED 


Error 上 aturation 
mpPut >= UPPer int 下 


SaveLog Close 


图 9.5.31 测试 用 例 生 成 过 程 的 日 志 


1 .446 。 5 -- 器 
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以 下 日 志 说 明了 测试 用 例 生 成 的 过 程 : 
(1) 生成 测试 用 例 ， 


Generating tests,. . . 


SATISFIED 
PID Controller/PID Controller/Saturation 
input > = Upper limit 


08-0Oct -2010 13:15:01 
CompJeted normal1Yy. 


(2) 生成 测试 用 例 对 应 的 数据 文件 : 


Generating output files: 


Data file 1 
D:\MRTLRAB FILES\DC_motorN\sldv_output\DC_MOTOR mbd design verifier\VDC MOTOR_mbd design veri- 
fier_ sldvdata. mat 


《3) 生成 测试 用 例 模型 : 


Harness model: 
D:\MRTLRAB FILESV\DC_motorN\sldv_outputNDC_MOTOR_mbd _ design_verifierNDC_MOTOR_mbd design_ veri- 


fier_harness. md] 
(4) 生成 Smulink Design Verifier 报告 : 


Report : 
D:N\MRTLRB FILESN\DC_motorN\sldv_ output\DC MOTOR _ mbd design verifierN\DC MOTOR_mbd design_ veri- 
fier_Treport. html] 


08 - Oct - 2010 13:15:05 


Results generation completed. 


4. 测试 用 例 模型 
该 测试 用 例 模型 可 用 于 分 析 模 型 覆盖 度 ,如 图 9. 5. 32 所 示 。 





Inputs Test Unit {copled from DC_MOTOR_mbd_design_ver 抽 er} 


han 一 


Texdt 
Test Case Explanation 


图 9.5.32 测试 用 例 模 型 


王 .447 ee ; 
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双击 模型 左上 角 的 Input 模块 ,可 打开 Signal Builder 窗口 ,如 图 9. 5. 33 所 示 ; 双 击 模型 
右 侧 的 Test Unit ,可 查看 原 模 型 ;双击 模型 左下 角 的 Test Case 下 xplanation 模块 , 则 在 MAT- 
LAB 编辑 器 窗口 显示 测试 用 例 说 明 。 

打开 Signal Builder 窗口 与 测试 用 例 说 明 ,可 以 更 好 地 理解 测试 用 例 的 作用 。 


六 Test Case1 








图 9.5.33 测试 用 例 


Test Case 1 (4 Objectives) 


Parameter Values 


1. PID Controller/PID Controllery/Saturation 一 input > Jower Limit 了 FF @ TIT=0.02 
2，PID Controller/PID Controller/Saturation 一 :input > lower limitT @T=0.00 
3.PID Controller/PID ControllLer/Saturation - :input >= Upper limitF @T=0.00 
4，PID Controller/PID Controller/Saturation 一 input > = upper LimitT @T=0 


S，Simulink Design Verifier 报告 


Simulink Design Verifier 报告 包括 5 个 部 分 : 
(1) 报告 第 1 节 Summary 列 出 了 Design Verifier 分 析 的 基本 信息 .测试 目标 的 数量 等 ， 
如 图 9. 5. 34 所 示 。 


Chapter 1. Sumimary 


Analysis Informaton 


Modei DC_MOTOR _ mbd design_verifler 
NMode- TestGeneration 

StatuS- Completed normably 

Analysis Time: 0s 

Objectives Status 


Number of Dbjectives: 4 
Objectives Satisffed 4 


图 9.5.34 第 1 节 Summary 


(2) 报告 第 2 节 Analysis Information ,根据 模型 的 不 同 , 包 含 以 下 几 个 小 节 的 全 部 或 部 
分 ,如 图 9.5. 35 所 示 。 
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Chapter 2. Analysis Information 


Table of Contents 


Modeillntormation 
Anaiysis Options 
Approximations 


Model Information 


D4MATLAB 


上 Ne 
AN oo 人、 





图 9.5S.35 第 2 节 Analysis lnformation 


表 9.5.3 报告 第 2 节 各 小 节 意 义 


小 节 意 义 
Model Information 列 出 了 模型 的 基本 信息 :模型 路 径 .修订 版 本 .最 后 一 次 保存 时 间 .作者 等 


列 出 了 Design Verifier 的 分 析 设 置 ,选择 菜单 项 Tools ~> Design Verifier 一 (Op- 
tions. . . 可 以 修改 这 些 设置 


Analysis ()ptions 


如 果 模 型 中 包含 不 支持 的 元 素 , 用 户 可 以 通过 启用 automatic stubbing 功能 ,检查 


Unsupported elements 


这 些 元 素 
Constraints 列 出 了 Design Verifier 软件 在 分 析 模 型 时 的 测试 条 件 
Block Repliacements Summary 如 果 Design Verifier 软件 蔡 换 了 模型 中 的 某 些 模块 , 则 列 出 模块 替换 信息 
Approximations 列 出 了 Design Verifier 软件 在 分 析 模 型 时 使 用 的 近似 类 型 


(3) 报告 第 3 节 Test Objectives Status 总 结 了 整个 模型 的 测试 目标 .目标 类 型 .响应 该 测 
试 的 模块 及 描述 ,如 图 9. 5. 36 所 示 。 
Chapter 3. Test Objectives Status 
Table of Contents 


Obiectives Satisfied 


Objectives Satisfied 


Simulnk Design Verifier found test cases that exefrcise these test Objectrves 


天 Type WModel item Description Test Case 

1 Decision CE inp 达 > Jower Jimit F 1 
2 Decision OCT EN > IDOwWer hrmit 了 1 

3 Decision RE inpti>= Upper jimmit 和 外 

4 IDeasion RID ControlerF 忆 input >= Upper lirnt 了 上 


Controller Saturation 


图 9.5.36 第 3 节 Test Objectives Status 


(4) 第 4 节 Model Items 列 出 了 每 个 被 测 模块 的 测试 类 型 .描述 .测试 状态 等 ,如 图 9. 5. 37 
所 示 。 
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chapter 4. Model ltems 


Table of Contents 
PID ControkterrPID ControlenSaturabhon 





This section presents, for each object inthe model defining coverage objectrves, the fst of oblectives and ther 
Individual status at the end of the analysis tshould mmatch the coverage report obtained from running the 
generated test Sulte on the model either from the harmess model of by using the skdvruntests command 


PID ControllerPID Controller/Saturation 

















国 本 二 
| | |Test 

本 ee 
HL__Ipecson jnpu>ilowerimtF |Satsfed | 
2 jpecision 二 ___jinput>lowerlimtT _ jsSatisfied 1 

3 ipeasom inpd>=upperlimtF jsSatisfed 1 
4 pecasom jnpu>=upperimntT jsSatisied 1 | 


9.5.37 第 4 节 Model Items 
(5) 第 5 节 TeEst Cases 列 出 了 各 个 测试 用 例 的 目标 模块 以 及 测试 效果 ,如 图 9. 5. 38 所 示 。 


IChapter 5. Test Cases 










Table of Contents 

|TestCase1 

|ms Secbon Cordains detailed informatiorn abou eacCh Generalted 4esl Case 

Test Case 1 

Summary 

|Length 0.02 Seconds (3 sample periods) 

|Obiecive Count4 

Siep Time Modelitem _ 四 Objectives 
PID ConfgroterPID ControlerSaturation impu> ower amitT 


| | 
PIO CortokePID C rrSahuration MinPU > 三 











图 9.5.38 第 5 节 Test Cases 


6. 覆盖 度 分 析 报 告 选项 


在 分 析 之 前 ,用 户 应 指定 必要 的 模型 覆盖 度 选 项 ,选择 模型 窗口 的 菜单 项 Tools 一 Cover- 

age Settings. . . ,打开 覆盖 度 设置 对 话 框 ,如 图 9. 5. 39 所 示 。 
| Coverage :Rerults 上 Reporting | Options ， 

ICoverage for this model: DC_NWOTOR_mnbd_design_ verifier 

二 LT subsystens are lrcluded 


| 局 Coverage for referenced models 


| AlL1 referonced model3 are includesd 


ER 


Covwerage Eor Erzternal Enabedded ATLADB files 


Covaerage Petrics 


民 ; Decisiom Fi Condition 
可 JICDC 轩 ] Loolkup Table 
:Signal Range 呈 | Sigral Size 


| Simulink Design Verifier 


图 9.5.39 覆盖 度 设置 对 话 框 
一 下 
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(1) Coverage 选项 卡 。 

@ 选择 模型 及 子 系统 。 勾 选 Coverage for this model 前 的 复 选 框 或 继续 单 击 Select Sub- 
system. . . 按钮 ,选择 需要 检查 的 子 系统 。 仿 真 过 程 中 ,系统 将 收集 并 报告 选 定 模型 或 子 系统 
的 覆盖 度 信 息 。 

@) 选择 引用 模型 。 对 于 包含 引用 模块 的 模型 ,可 勾 选 Coverage for referenced models 复 
选 框 或 继续 单 击 Select Models. . . 按钮 ,选择 需要 分 析 的 引用 模型 。 仿 真 过 程 中 ,系统 将 收集 
并 报告 全 部 或 个 别 指定 的 引用 模型 的 覆盖 度 信 息 。 

Simulink V&YV 软件 , 仅 针 对 工作 于 Normal 仿真 模式 下 的 引用 模型 给 出 覆盖 度 报 告 ,对 
于 Accelerator 仿真 模式 ,Simulink V&V 软件 是 无 法 记录 其 覆盖 度 的 。 

@ 检查 外 部 Embedded MATLAB 文件 。 勾 选 Coverage For 下 xternal Embedded MAT- 
LAB Files 复 选 框 , 在 仿真 过 程 中 ,系统 将 收集 并 报告 模型 中 Embedded MATLAB Function 
模块 或 Stateflow 图 表 小 调用 到 的 M 文件 的 覆盖 度 信息 。 

申 选择 覆盖 度 检查 类 型 。 模 型 覆盖 度 分 析 类 型 如 表 9. 5.4 所 列 。 

表 9.5.4 覆盖 度 分 析 类 型 


类 型 名 称 
Cyclomatic Complexity 循环 复杂 度 
Decision Coverage (DC) 判决 覆盖 度 
Condition Coverage (CC) 条 件 覆 盖 度 
Modified ConditionVyDecision Coverage (MCDC) 修改 的 判决 /条 件 覆 盖 度 
Lookup Table Coverage 查 表 覆 盖 度 
Signal Range Coverage 单一 范围 覆盖 度 
Signal Size Coverage 信号 大 小 覆盖 度 
Simulink Design Verifier Coverage Simulink 设计 验证 覆盖 度 


有 些 Simulink 模块 可 以 接受 任何 一 种 的 覆盖 度 检查 ,而 有 些 模块 却 只 能 接受 其 中 的 某 些 
检查 。 对 于 Stateflow 状态 .事件 及 状态 时 序 逻 辑 判 决 , 只 能 得 到 判决 覆盖 度 ; 对 于 Stateflow 
状态 转移 , 则 可 以 得 到 DC、\CC、MCDC 三 种 覆盖 度 。 对 于 上 述 参数 设置 及 覆盖 度 类 型 的 意义 
及 各 模块 可 接受 的 检查 类 型 ,用户 应 事先 参阅 帮助 文档 。 

对 于 不 同 的 引用 模型 ,如 需要 各 自 执 行 不 同类 型 的 覆盖 度 检查 ,可 以 使 用 命令 cv. cvtest- 
group 与 cvsimref ,具体 用 法 请 参阅 帮助 文档 。 

(2) Results 选项 卡 。 该 页 有 5 个 选项 ,如 图 9. 5. 40 所 示 。 


[ceverage | Results 


men ww 一 一 -一 一 = 一 


卉 | Save cumulative results in workspace variable 
| we 四 
| cvdata object maae: covCumulatiVeData 


| 园 Save last run in workspace variable 
Cvdat3 0bjec 上 t TameE: covdata | 


; 名 Increnent variable name vith each sinulatior (varl，var2，...) 


芝 Update results on pause 
: 进 DisplLay coverage results Using nodel coloring 


图 9.5. 40 ”Results 选项 卡 
25 : 
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Save Cumnulative Results in Workspace Variable。 累 积 各 次 的 覆盖 度 检 查 结果 ,以 cv- 
data object name 文本 框 内 的 文字 作为 对 象 变量 名 ,保存 在 MATLAB 工作 空间 。 
@ Save Last Run in Workspace Variable。 在 MATLAB 工 作 空 间 保 存 最 近 一 次 的 覆盖 


度 检查 结果 ,以 cvdata object name 文本 框 内 的 文字 ,作为 对 象 变量 名 。 


@ Increment Variable Name with Each Simulation。 按 顺序 逐个 保存 最 近 一 次 的 覆盖 度 


检查 结果 ,避免 以 往 的 结果 被 覆盖 。 


曲 Update Results on Pause。 系 统 在 仿真 暂停 时 ,立即 给 出 覆盖 度 检 查 报 告 ,随后 用 户 可 


以 继续 执行 仿真 ,在 下 一 次 暂停 或 停止 时 ,再 次 更 新 检查 报告 。 


G@) Display Coverage Results Using Model Coloring。 根 据 覆 盖 度 程度 ,以 不 同 颜色 显示 
各 个 模块 。 例 如 全 覆盖 的 模块 ,显示 淡 绿 色 ,不 完全 覆盖 的 模块 ,显示 淡 红 色 。 
(3) Report 选项 卡 。 该 选项 卡 各 选项 ,用 于 设置 是 否 生 成 以 及 如 何 生成 检查 报告 ,如 图 


9. 5.41 所 示 。 


| Coverage | Results | Report1irng | Options | 





局 cenerate HITIL report |HTIML Settings| 


Cumaulat1lVve Luns 


8 Last run 


Additional data to include in report (cvdata objects): 


O Generate HITML Report。 当 系统 完成 覆盖 度 检查 时 ,生成 检查 报告 ,同时 在 MAT- 


图 9. 5. 41 Report 选项 卡 


LAB 网 页 浏览 器 显示 ,如 图 9. 5. 42 所 示 。 


@) 单 击 右 侧 的 Settings 按钮 ,用 于 设置 报告 选项 ,意义 如 表 9. 5.5 所 列 。 











哆 | HTML Settings | 
| 园 Include each test in the model summary 
已 Produce bar graphs ln the model SUrmary | 
园 Use two color bar graphs (red,blue) 
| Display hit/ycount ratio in the model SUmmary 


[| Do mot report fully covered model objects 





局 Include cyclonmatic conpJexity muUnbers li 3SUmnary 








| 加 Include cyclomat1c comnplexity Pumbers ln block detalls 


下 
拓 | 
| Filter Stateflow eVvents from report 
| | 





图 9.5.42 报告 选项 
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表 9.5.5 模型 覆盖 度 报告 选项 


报告 选项 意义 
在 报告 上 部 ,给 出 每 一 个 测试 用 例 的 覆盖 度 列表 ,如 果 取 消 该 
项 , 则 仅 给 出 总 的 覆盖 度 报告 


Include each test in the model summary 


Produce bar grabhs in the model summary 以 条 状 图 例 显示 覆盖 度 
Use two color bar graphs (red，blue) 用 红 蓝 两 色 蔡 代 条 状 图 例 中 的 黑白 两 色 , 便 于 识别 
Display hit/count ratio in the model surmmary 以 百分比 及 分 数 形 式 同 时 显示 覆盖 度 ,如 80%% (475) 
报告 里 不 体现 全 覆盖 模块 ,这 样 能 明显 减 小 报告 ,这 在 测试 用 


Do not report fully covered model objects 
例 开 发 阶段 特别 有 用 


在 报告 里 体现 模型 及 其 第 一 级 子 系 统 ,Statefiow 图 表 的 循环 
Include cyclomatic compljlexity numbers in sumtmary 复杂 度 。 在 计算 复杂 度 时 ,系统 将 子 系统 以 及 Stateflow 图 表 看 
作 一 个 对 象 ,以 黑体 显示 复杂 度数 值 


Include cyclomatic complexity numbers in block details 在 报告 的 模块 细节 部 分 体现 循环 复杂 度 检 查 结 果 


Filter Stateflow events from report 排除 Stateflow 事件 的 杰 闭 度数 据 


@ Cumulative Runs。 本 次 生成 的 报告 里 体现 此 前 各 次 积累 的 覆盖 度 检查 结果 。 

曲 Last run。 本 次 生成 的 报告 里 仅 体 现 最 近 一 次 的 检查 结果 。 

人 Additional data to include in report。 本 次 生成 的 报告 里 加 入 以 前 检查 的 结果 ,在 文本 
框 区 域 输入 数据 的 名 称 。 

(4) Options 选项 卡 。 

| Coverage ] Results ] Reporting | Options | 

广 ) Treat Simulirk Logic blocks as short-circuited 
Iv Warmnm when unsupported blocks exist in model 


名 | Force block reductiomn off 


图 9.5.43 ”Options 选项 卡 

GD Treat Simulink Logic blocks as short-circuited。 在 进行 获 盖 度 检查 时 ,对 于 逻辑 模 
块 ,如 果 某 一 个 输入 能 立即 决定 该 模块 的 输出 , 则 忽略 该 模块 的 其 他 输入 。 例 如 逻辑 与 模块 ， 
如 果 有 一 个 输入 “ 非 ”, 则 整个 模块 输出 “ 非 *, 其 他 输入 不 再 起 作用 ,如 同 将 * 非 ?输入 端 与 输出 
端 短路 。 

该 选项 仅 对 DC 及 MCDC 覆盖 度 检 查 有 效 , 这 可 能 会 导致 模型 覆盖 度 达 不 到 100%% 。 

Q@ Warn when unsupported blocks exist in model。 如 果 模 型 里 含有 无 法 执行 覆盖 度 检 
查 的 模块 ,在 仿真 结束 时 ,将 提出 警告 信息 。 

人 Force block reduction off。 如 果 用 户 在 模型 参数 配置 窗口 启用 了 Block reduction ,如 
果 勾 选 该 复 选 框 , 则 系统 在 收集 模型 覆盖 度 信息 时 ,忽略 Block reduction 选项 。 
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7。 模型 覆盖 度 报告 


完成 上 述 设 置 后 ,选中 Signal Builder 窗口 所 示 的 某 个 测试 用 例 , 单 击 工具 栏 上 的 仿真 按 
钮 , 即 得 到 该 次 测试 的 覆盖 度 报告 ,如 图 9. 5. 44 所 示 。 


File Edt Sroup Signal  Axes 晶 elp 


成 园 类 区 研 呈 了 了 灿 虞 丈 汉 开园 mm 人 旭光 


1 Test Case1 ， 旱田 
单一 测试 ”批量 测试 


图 9.5.44 运行 测试 用 例 
报告 显示 可 以 得 到 100 多 的 模型 覆盖 度 ,如 图 9. 5. 45 所 示 。 











Details: 







I. Model "DC_MOTOR_ mbd_design_verifier harness” 


Child Srscerms: 








Coverape (chis object) 






图 9.5.45 覆盖 度 报告 


Design Verifier 主要 是 为 了 测试 含有 复杂 逻辑 的 多 分 支 系 统 , 例 如 含有 if. . . else. . . 等 结 
构 时 ,Design Verfier 生成 测试 用 例 ,测试 系统 在 任意 可 能 情况 下 的 响应 是 否 符 合 要 求 。 而 本 
例 并 不 含有 这 些 结构 ,测试 用 例 仅 仅 针对 输出 饱和 的 上 下 限 ,使 这 项 测试 显得 意义 不 大 。 但 本 
例 仍 不 失 为 一 个 如 何 使 用 Design Verifier 工具 的 例 程 。 


9.5$.3 Model Advisor 检查 


1. 启动 Model Advisor 


在 启动 Model Advisor 前 ,要 确保 当前 目录 未 写 保 护 。 启 动 之 后 ,Model Advisor 在 当前 
目录 下 建立 一 个 子 目录 slprj ,用 于 存放 检查 报告 及 其 他 信息 。 

用 户 可 以 在 模型 窗口 ,选择 菜单 项 Tools->Model Advisor, 在 System Selector 窗口 (图 9. 5. 46) 选 
择 总 体 模 型 或 模型 下 的 子 系统 。 

对 于 子 系统 ,用 户 可 以 直接 选择 子 系统 右键 菜单 的 Model Advisor 命令 。 

本 演示 过 程 选 择 总 体 模型 DC_MOTOR_mbd。 


1 .454 - 
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最 System Selector - Model Advisor 国 午 





Choose aa system 上 ro 有 the hierarchy: 


二 CDIORLnba 

CDFREEOT SITEF3 ET 
| | DC_motor_subsyst en 
忆 PID Controller 














图 9.5.46 启动 Model Advisor 


2. Model Advisor 窗口 
选择 模型 或 子 系统 后 ,系统 显示 Model Advisor 窗口 (图 9. 5. 47) 。 











加 Model Advisor - DC_MOTOR_mbd 
[Fle -Edit Run View Hep 








1 Find: 王 | 
站 me 一 -一 一 一 一 一 Model dvicor | 
a Modei Advisor | | 
辣 1 
< 匡 BypProduct Verify model complies with modeling 时 || 
才 SirmolimK | 了 站 
世 芝 guidelines. | 电 
车 Real-Time Workshop EmbeddedO } 避 肯 
A | 
大 号 Simulink Verificaionand Walkial TO SRSDI 要 0T 和 和 让 本 CA 下 二 全 5 才 帮工 本寺 有 直方 开 下 CE 世 OE 六 在 区 二 起 丰 | 
| SmuhinkCcontrol Design the hack ED3E， 习 | 
凤 | 二 3 6Y 配 5k Ye anabl16 9F di55bls aILT Shocks ithin 8 5older，x5ght-cl36K 《hg | 本 | 
folder and then clickE “Setect 上 Ai” or “Deselect AI | 
Foxy 到 ist 5 5 Do5i5ib2e action5，yigst-clicxk ar objact 50 《9 68 
Pene. | 
Te Yun checks，55jlect 二 iolder 0T Shacxk in the 3aft Pane 
| LasgEarnd } 
上 ou | 
本 Passsd 
个 FL sd 


” unnzing his check YTEEEETS an Updats Dagzaz， 


| 
作 了 | 
| 





图 9.5.47 Model Advisor 窗口 


展开 窗口 左 侧 的 任务 树 ,选中 某 一 类 或 某 一 项 检查 , 右 侧 任务 管理 窗口 显示 对 应 项 目的 检 
查 说 明 检查 结 果 、 检 查 按钮 等 。 

如 果 用 户 先前 已 经 执行 了 模型 检查 ,那么 下 一 次 打开 Model Advisor 时 , 则 显示 上 一 次 的 
检查 结果 、 修 改建 议 等 ,再 次 执行 检查 后 , 旧 的 检查 结果 将 被 覆盖 。 
选择 菜单 Edit-~reset 可 以 将 撤销 当前 的 所 有 检查 结果 。 

3. 执行 检查 


(1) 展开 节点 By Product, 勾 选 下 属 的 Simulink 检查 项 前 的 复 选 框 。 
人 
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(2) 单 击 节点 Simulink, 单 击 右 侧 页 面 的 Rmseecedceds 按钮 ,开始 检查 。 
(3) 检查 完成 , 右 侧 窗口 显示 检查 结果 (图 9. 5. 48) 。 移 表示 通过 检查 项 目 , 侈 表示 失败 项 目 ， 
念 表 示警 告 项 目 , 口 表 示 未 检查 项 目 ; 左 侧 任务 树 的 节点 图 标 对 应 显示 了 该 项 检查 的 状态 。 

















吕 Model Advisor - DC -MOTOR-mbd xc 全 
File 上 di ae Visw Help 
~ 多 
4 Model Advisor aa 洛 ; esi 
4 国 专 By product oaai jdvisor 本 
4 | 况 二 Simulink | 并 中 大生 贡 了 和 | | 
网 四 check model, lccal iibraries and rie jan_Selected Checks 量 
鼠 ) 包 jdentify unconmnected lines, input pol | 西 shoe report after mm 
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二 
图 9.5.48 检查 结果 


4. 还 原点 

在 修改 警告 或 错误 之 前 ,最 好 先 设置 还 原点 ,以 便 撤 销 操 作 。 还 原点 只 保存 当前 模型 、 
Model Advisor 状态 及 基本 工作 空间 变量 ,不 保存 诸如 库 文件 .引用 子 模型 等 其 他 信息 。 

(1) 保存 还 原点 。 

@ 确保 当前 的 工作 目录 为 模型 所 在 的 目录 。 

@) 选择 Model Advisor 窗口 菜单 项 File 一 Save Restore Point As. .. 。 

@@ 在 还 原点 对 话 框 下 部 的 Name、Description 栏 输入 还 原点 名 称 及 描述 文字 , 虽然 描述 
不 是 必需 的 ,但 可 以 帮助 用 户 区 分 各 个 还 原点 (图 9. 5. 49) 。 

田 单 击 Save 按钮 ,保存 还 原点 。 


葡 Model Advisor Save Model and Data Restore point - DC_MOTOR _.. 


Jo restore et 抽 SSved 














图 9.5.49 保存 还 原点 
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用 户 也 可 以 选择 Model Advisor 窗口 菜单 项 File->Save Restore Point ,快速 保存 还 原点 ， 
这 时 系统 使 用 默认 名 称 autosaven, 其 中 为 顺序 号 。 使 用 这 样 的 保存 方式 ,无 法 后 期 修改 还 
原点 名 称 及 描述 。 

(2) 导入 还 原点 。 

@) 选择 Model Advisor 窗口 菜单 项 File 一 Load Restore Point。 

@) 对 话 框 列 出 所 有 的 还 原点 名 称 描述 .保存 时 间 , 用 户 可 据 此 选择 需要 的 还 原点 (图 9. 5. 50) 。 

@@ 单 击 Load 按钮 ,在 后 续 出 现 的 确认 对 话 框 中 继续 单 击 Load 按钮 ,完成 还 原 。 

用 户 还 可 以 选中 已 有 的 还 原点 , 单 击 Delete 按钮 ,删除 还 原点 。 


Saiauasaiaoviiaivaauiauipuiacaioivaiuiuaioiaoiivaa iaaiaueiiiuaauauaiouiiuoau aaaoiiioiuuu auaaaa iauaiucaa iis an 
且 王 朋 已 Descrlbpt1lonm TIme | 


09-0ct-2010 13:34:11 | 
二 


[Case 


图 9.5.50 导入 还 原点 





s， 修改 警告 及 错误 

警告 及 错误 说 明 当 前 模型 或 子 系统 的 设置 并 不 是 最 优 的 ,用 户 可 以 根据 检查 报告 修改 对 
应 的 警告 及 错误 。 

本 节 只 说 明 修 改 的 一 般 过 程 , 不 具体 讨论 某 一 项 检查 的 意义 ,各 类 检查 的 详细 说 明 ,可 以 
在 帮助 窗口 输入 Simulink Checks、Simulink Verification and Validation Checks 等 关键 字 查 
找 , 用 户 可 以 根据 实际 需要 确定 合适 的 检查 项 目 。 

修改 警告 及 错误 的 方式 有 以 下 3 种 : 

(1) 手动 修改 。 对 于 每 一 个 未 通过 的 检查 项 目 ,Model Advisor 都 给 出 了 修改 建议 ,例如 
检查 项 Check optimization settings 标记 了 黄色 惊叹 号 念 , 单 击 该 节点 , 右 侧 界 面 Analysis 结 
论 区 显示 修改 建议 (图 9. 5. 51) 。 


ResUlt: 入 克 armning 

You shculd turzn cn the fclilowing Cpctimizaticnis- 
InULzne DaTESNEtETE 
Kemocove code From floating~point to integEer DCnYwersicns5 +hat Wrap5 
DuUt-Dft-Trange Value5 


Inline znvariart ESzgnal5 


The Simulaticna Tange checking diagnostic i5 cnabied、 BecauUse thi5 


diagncstsac cn incTYrease the tioe it takes to samulate 7 了 COUT Bocdel， 
F*CuU shcould consider tuTnRinE it cfE，by 5etting its Value tc 
ODEe， 


图 9.5.5S1 手动 修改 
@ 分 别 单 击 链接 optimization 和 Simulation range checking, 系 统 自 动 打开 模型 配置 对 话 


， 因 基于 模型 的 设计 一 MCU 篇 


框 , 按 修改 建议 色 选 对 应 复 选 框 。 

@ 单 击 kmmsaex ,再 次 检查 该 项 目 , 节 点 图 标 变 成 侈 ,说明 检查 通过 。 

(2) 自动 修改 。 有 些 检查 项 提供 了 自动 修改 功能 , 它 能 自动 执行 Analysis 结论 区 列 出 的 所 有 
修改 意见 。 因 此 用 户 需要 事先 了 解 这 些 修 改 意 见 的 意义 ,如 果 不 需 要 全 部 修改 , 则 可 不 使 用 自动 修 
改 功 能 。 例 如 检查 项 Check usage of functiorrcall connections 标记 了 黄色 惊叹 号 鳃 , 单 击 该 节点 ,再 
单 击 右 侧 页 面 下 部 Action 区 的 按钮 sis sstsinss ,结果 区 列 出 本 次 修改 的 内 容 ,如 图 9. 5. 52 所 示 。 


去 cticm 


Modify the diagnostic 5etting5 in the aodel conftiguratiocn-. 
ET Sett3zamg5| 


本 
Res5U1L 七 : 
cenfziguraticn Parampceter5s zcdiftiecd 


DiaEgnostics/Cconnectivity > Contexzt 一 dependent inputs is set 
CEPmEDple 五 1 


图 9.5.52 自动 修改 


(3) 批量 修改 。 对 于 有 些 检 查 项 ,Model Advisor 提供 了 批量 修改 功能 ,Explore Result 
按钮 处 于 有 效 状 态 , 单 击 该 按钮 用 户 可 以 在 一 个 类 似 模 型 浏览 器 的 窗口 里 快速 定位 、 修 改 模型 
及 模块 参数 ,避免 逐个 模块 修改 ,也 避免 错误 修改 原本 正确 的 设置 。 


9.6， 定 点 模型 


进行 定点 信号 处 理 能 简化 电路 ,可 以 使 得 运算 简单 .运算 速度 提高 ,减少 运算 时 间 ,由 于 征 
点 信和 号 处 理 有 这 些 优 点 ,所 以 定点 信号 处 理应 用 较 广 。 对 于 骨 人 式 系 统 要 求 低 功 耗 ,而 且 芯 片 
的 体积 小 ,这 些 要 求 定点 信号 处 理 都 满足 ,而 浮 点 模型 功 耗 大 ,一 般 都 将 浮 点 模型 转 成 定点 模 
型 进行 信号 处 理 。 

而 定点 算法 中 数据 类 型 是 有 限 字 长 的 ,容易 引入 量化 误差 ,产生 溢出 ,所 以 在 将 设计 的 数 
据 类 型 从 浮 点 转化 为 定点 需要 考虑 以 下 三 点 : 

(1) 根据 硬件 特性 .输入 .输出 及 中 间 信 号 的 动态 范围 来 选择 合适 的 字 长 和 分 数 长 度 。 

(2) 在 定点 运算 中 限制 及 降低 量化 误差 的 传播 。 

(3) 在 硬件 实现 前 保证 定点 设计 满足 需求 。 

有 两 种 方法 可 以 将 浮 点 模型 转 成 定点 模型 进行 信号 处 理 : 

(1) 手动 设 定 字 长 ,再 借助 Fixed-point Tool 工具 检查 设置 是 否 满 足 设计 要 求 , 如 果 在 运 
算 过 程 中 变量 发 生 溢 出 , 则 用 Fixed-point Tool 工具 自动 定 标 。 

(2) 利用 Fixed-Point Advisor 工具 自动 定 标 , 再 借助 Fixed-point Tool 工具 进一步 优化 
定 标 。 
Fixed-Point Advisor 工具 可 将 模型 从 浮 点 转换 成 定点 ,产生 初始 定 标 来 调整 模型 配置 参 
数 和 模块 配置 参数 ,为 模块 和 数据 配置 初始 定 标 , 针 对 浮 点 模型 来 验证 初始 定 标 结 果 , 并 为 代 
码 生 成 做 准备 。 


55 师 
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Fixed-Point Tool 工具 可 以 进一步 优化 定 标 , 它 只 对 模型 中 已 经 设置 为 定点 数 的 变量 进 
行 分 析 和 操作 ,并 可 以 为 戏 人 式 代码 优化 定 标 ,折衷 范 围 和 精度 ,使 数据 不 溢出 ,产生 优化 的 定 
标 。 而 且 人 允许 用 户 指定 仿真 或 设计 的 数据 类 型 及 记录 模式 (最 小 .最 大 值 和 溢出 ), 选 择 自动 定 
标 信和 号 或 锁定 它们 以 防止 改变 ,使 用 数据 类 型 覆盖 来 支持 浮 点 到 定点 表示 的 快速 切换 ,还 可 产 
生 浮 点 设计 与 定点 设计 的 差 值 比较 图 。 


9.6.1 Fixed Point Advisor 


本 节 将 用 PID 控制 电动 机 模型 的 例子 具体 说 明 如 何 使 用 Fixed Ponit 工具 对 模型 定点 化 。 
如 前 文 所 述 ,最 终 的 嵌入 式 实现 代码 仅 与 PID Controller 子 系 统 有 关 , 因 此 这 里 也 仅 对 该 模块 
作 定 点 化 处 理 。 

由 于 模型 中 的 DC_motor_subsysterm 中 含有 不 支持 离散 求解 器 的 模块 ,首先 应 将 菜单 项 Simula- 
tion->Configuration Parameters 中 Solver 界面 的 求解 器 设置 为 可 变 步 长 ,如 图 9.6. 1 所 示 。 


Solver opt1lLons 








me FEED 习 savr OUT 和 
ax step S1LZe6; auto Relative t+tolerarnce:l 1e- 了 

Jan step SILIZe; auto Absolute tolerance: auto 

Initial step Size: auto Shape preSservat1Ion: [Disable all ae 
Number of consecut1Ve min steps; ] 


9.6.1 求解 器 设置 


1、 启 动 Fixed Point Advisor 
在 PID Controller 子 系统 上 右 击 ,选择 Fixed Point-~>Fixed Point Advisor 命令 ,打开 图 9.6. 2 
所 示 的 对 话 框 。 


加 Fixed-pPoint Advisor - DC_MOTOR_mbd/PID Controlier 
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E apo407 20661 De 
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图 9.6.2 Fixed-Point Advisor 界面 
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其 中 包括 四 项 任务 :人 为 模型 转换 作 准 备 (Prepare Model for Conversion) ; @ 为 数据 类 型 
和 自动 定 标 作 准 备 (Prepare for Data Typing and Scaling); @ 执 行 初 始 数据 类 型 和 自动 定 标 
(Perform Data Typing and Scaling); 全 检查 模型 的 设置 是 否 适 合 代码 的 生成 (Prepare for 


Code Generation) 。 


2. 执行 定点 化 任务 
在 顶级 任务 目录 Fixed-Point Advisor 上 右 击 ,选择 Run to Failure 选项 即 可 开始 定点 化 工作 ， 
如 图 9. 6. 3 所 示 。 


4 | 大 Fixed-PointAdvisor -一 
1 Prepare Model for Caase 
| 


ia 2 Prepare for Data Typ 
3. Perform Data TYping 


? 
iD 4. PrepareforCcode Ge | 


图 9.6.3 执行 定点 化 任务 


3. 修改 警告 及 错误 
(1) 在 用 户 没 有 自行 对 模型 做 过 其 他 与 定 标 相 关 的 设置 的 情况 下 ,第 一 个 任务 Verify 
model Simulation settings 就 会 失败 ,如 图 9. 6.4 所 示 。 报 告 中 详细 列 出 了 错误 原因 和 修改 意 
见 , 用 户 可 单 击 下 方 的 Modify Al 按钮 自动 修正 错误 。 然 后 在 对 话 框 的 菜单 栏 选择 Run -~ 
Run to Failure 继续 执行 任务 。 


Result : 从 Failed 


Fssled : Incoryrect Siamulation 5ettings in the Fized-Point Teol. To fiz the failure，click the Modzaf7 
AtiI button Cr clicx the hyperliink tc launch the Fixzead-Point Tool dialog and manuall7 appl7 +the 


TecoOemended 5etting. 


Re _Pixed-Point _Tooi Settings 
古 二 Sa 力 mt 让 RE 国王 Hereeet 风 引 尖 _ 区 ecommended RE 
MOTOR mbdrPID ControljJexrEi on | 届 Se 工 OC8SI ings | 权 inimums， maximums and 
joverfi OEE 





Passed : Signal 1ogging is ESEelected in the Configtration Parameters > Data TDPport/ ExYpozt Pane- 


Passsed - The fipref object DataTypeOverride is5 5et to “ForceOff 


二 C 丰 OP 


Configure Bocdel for reccommernded 5iculiation 5ettings and fipreft object. 
图 9.6.4 验证 模型 仿真 设置 任务 界面 


(2) 任务 执行 到 set up signal logging 时 ,再 次 出 现 错误 ,如 图 9. 6. 5 所 示 。 右 边 页 面 显示 


执行 任务 失败 的 原因 为 至 少 需要 指定 一 个 信和 号 的 数据 被 记录 。 
单 击 下 xplore Resujlt 按钮 打开 Model Advisor Result Explore 对 话 框 , 在 界面 中 色 选 每 个 


模块 的 EnableLogging 复 选 框 , 如 图 9. 6.6 所 示 , 然 后 再 次 运行 该 任务 。 
1 Go 
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Regualt: 忆 CD Faziletd BRBxplore Result.. 。 
FELeG 


Specifry at 1Ieast Cne FEIEBnal tc be logged、 TO smnabie LogEInRE For 5EEnaLTS5 CE 
intexrest， either clicx the “Explore Resault. . . ”button or EC back to youz Bacdsl 
and right-clicoxk the 1ine that represents the Sizgnal to Dpen the “Signal 


Przroperties”diaiog 





| 
| 


| Signal analysis resudit 
[Sieaali Category inique SiEgnal Count 
[| Logged | 有 T  ” j 
| ”和 icgged | 3 | | 








图 9.6.5 设置 信号 记录 任务 界面 


| Name SourceBlock SourcePortNumber EnableLogging UserSspeciffedLogName 


FT 局 
二 加 


图 9.6.6 设置 信号 记录 


(3) 执行 到 1. 6 项 时 ,会 出 现 若 干警 告 , 例 如 1. 6. 1 项 check model configuration validity diag- 
nostic parameters setting 的 警告 为 Configuraion Parameters 中 的 参数 设置 不 合理 ,如 图 9. 6.7 所 示 。 


Regsult : 本 Warning 


” ”Configuration Parameters Settings 【Diagnostics >》 Data Vaiidity 
Parameters settings) 


Settings Current 区 ecommended | 

















RSSR : Easy 
Detect dewncast |exxcz arnine 
Petect overficw ]|ezrez | arnine 








图 9.6.7 检查 模型 设置 与 诊断 参数 设置 任务 界面 


用 户 可 以 手动 修改 这 些 警告 。 单 击 链接 Detect_downcast, 打开 设置 界面 ,并 按照 建议 设 
置 为 warning, 如 图 9. 6. 8 所 示 。 其 他 警告 可 按 同 样 方法 修改 。 


Parameters 


Detect downcast: | warning | Detect overfTow: 
Detect Underflow: none We Detect precision 10331 [varming | 
Detect 1oss of tunablility: 





图 9.6.8 修改 参数 
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由 于 之 前 选择 的 顶点 对 象 并 非 顶 层 模型 ,1. 6. 3 项 check for proper bus usage 的 警告 无 
法 修改 ,其 警告 如 图 9. 6. 9 所 示 ,提示 说 只 有 在 顶层 模型 运行 该 项 才能 检测 。 该 警告 并 不 影响 
定 标 任务 的 执行 。 
Rasgult: 从 warning 


The “Proper Bus Usage checkx woOrX5 CnIF frca top-ievsl oocodels。 Run tha Advigoz 
From the top-Ievel zcodel tc Dezforz thi5 checE. 


图 9.6.9 检查 总 线 使 用 情况 任务 页 面 


(4) 执行 到 2. 2 项 Remove output data type inheritance 时 出 错 , 提 示 有 若干 模块 的 输出 
数据 类 型 为 继承 ,如 图 9. 6. 10 所 了 示 。 用 户 可 单 击 Modify All 按钮 自动 修改 。 


Rasalt: 仿 Failed xzplore Rasuit- ui 
了 


Bl1OoJE 5 the rolliow3neg 《ablie Rav6 《beiz Output dafta t+7pe specified Using En inhesritance FUIe、Set the 
Pieocx Output data 《TDPeE DO 《he DuUTY6nT PTCPaSEtSC dt ATPDe 65 7 了 60032060660 











iocx jcompiied Data Type [Curremt Reccmmended 

| EID ccatzroliezy Ia ,oubie Enperit: ante double 

| PEIE Csaotrcljary7Iez ;goubie nerit: actc jpobie 
| .FID Zaatzolisry sum [aoubie enheszit: Teherit Via EnternaT TUIG OUb34 可 
雪 在 王 站 了 


ExplicitIy configurze the CuUtput data t7pe t+0 the Yecosscnded Value Where pDsEtble- 


[esifr All ] 


图 9.6.10 取消 输出 数据 类 型 的 继承 设置 任务 页 面 


(5) 执行 到 2.5 项 Verify hardware selection 时 出 错 ,提示 用 户 选择 硬件 ,如 图 9. 6. 11 所 
示 。 考 虑 到 本 实验 最 终 要 在 ARM 芯片 上 实现 ,硬件 应 选择 ARM7 。 


Resuj3t- 友 Failed 


Faitled 
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图 9.6.11 验证 硬件 选择 任务 界面 


单 击 链接 Hardware Implementation Device _settings, 打开 设置 界面 ,选择 ARM7 ,并 设 
定 取 整 方式 (Signed integer division rouds to) 为 zero, 如 图 9. 6. 12 所 示 。 


Enabedded hardware (Simulation and code generatior) 





Device Vendor: La Compatible 中 | Device typei [an 7. No 了 
Jamber of bits Largest atomic BIz6 | 
char; 3 Short: 6 nt Er 
integer: Long w 
long:; 32 float; 史 double; 剖 2 
站 ， fl1oating-pointi IF1oo5 2 
扑 玫 二 ji polnter1: as acimene 过] 
Eeeaerweenmraecwaenprpveeenrepeaaweenepawe 少 Ce 
Byte ordering: Little Ezndian 了 | Sigmed integer divisior rounds to0r [Zex ] 





如 Shift right om a sligred imteger as aritlmaetic shift 


Le 图 9.6. 12 ”Hardware Impiementation 界面 
"462， < 兖 
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(6) 执行 到 2.7 项 specify block minimum and maximum values 时 出 错 , 提 示 有 若干 模块 未 定义 
最 大 值 或 最 小 值 ,如 图 9. 6. 13 所 示 。 


Resudl 人 t 入 Warnins [Explore Resuit. 


Focrz Decaningftul 5calinEg，3SpPecizy at 883 tha Outpet 引 ziniDuS an 
2axzdiua values or Znpozt blocxas 0 the 57S5teD undezy conveTS3ORn- 


[| Win And/or Maxz Not Specified 


Category ”Simulink blocks 
Fnmpexts 扰 时 末 
thez biccks 

[Total 3 


图 9.6.13 指定 模块 最 大 /小 值 任 务 页 面 


单 击 Explore Result 按钮 ,打开 Model Advisor Result Explore, 如 图 9. 6. 14 所 示 。 根 据 
模块 仿真 过 程 中 记录 的 最 大 值 或 最 小 值 ,容易 确定 其 输出 值 (OutMin/OutMax) 的 范围 。 


亚 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


Name BlockType SmMin SImMax OutMin OutMax 


局 ma inpcor 31535399 240354 [46 [245 
大 页 wo  D 


图 9.6.14 指定 模块 最 大 /小 值 


(7) 执行 到 3. 1 项 Propose data type and scaling 时 出 错 , 提 示 未 指定 需要 的 数据 类 型 ,如 图 
9. 6. 15 所 示 。 


Kesult: \》 Failsd 


“ynput Farzranpeters” [above) invalid Yoc St 5peczfr valid valucs and YezruUn 《he 
上 己 SK. 

ID 上 已 aaT 志 本 已 在 所 工 二 Current SettimE 二 dvice 
pata trpPe for toOp-evel | undefined TInvalid datE t7Pe、Entez an 


| npozt biocxs 了 PPpropriate datE t7Dpe 0OT 5E1eCctt 


| ne fxzom the 5t. 


Data typPE for Constant | 。 undefinedc Envalid datE t7De，Entez an 
jbloccks | apprcpriate data type DT 5El1ect 
| ons froz the 5t. 





- -一 -一 一 -一 -一 -- 一 一 一 ae 机 





IT other dats trpas undafined Invalid data ty7pPE，、Entez an 
joseociate [at Et7PG DY 5 6 二 


IonmE fxoa the 了 


9.6.15 数据 类 型 及 定 标 任务 页 面 


由 于 选择 的 是 ARM7 芯片 ,为 32 位 处 理 器 ,因此 ,将 数据 类 型 暂 定 为 有 符号 32 位 定点 数 , 如 图 
9. 6. 16 所 示 。 


3. 1 Propoese dats type and scaling 
Anazrsis ( Triggers Update Diagrsg 


Pzovide 75xedpoant data “rpe and 56alineg zcor 5ca2abze 日 iocks。 


JRPUY PTSDCTY GT 
Daxza tyDpe zcoz top-1evel Inpozt bliccks zazdt1f2， 32. 洁 本 
Pa*za 《7D6 zc7 Congtant 日 125XS 0d4513 32， 36 王 


Daxa 《7DpE ?co7 EL Dothey b20cX5S 2 


图 9.6.16 指定 数据 类 型 ar、 
“463 昌 1 
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考虑 到 定点 化 后 ,PID Controller 子 系统 的 输入 /输出 信号 数据 类 型 已 经 与 其 他 模块 不 
符 , 因 此 需要 在 该 模块 的 输入 /输出 口 添加 数据 类 型 转换 模块 ,如 图 9. 6. 17 所 示 。 


PID Controller Outpult 
PE 
Conve In2 Actual 
PiID Controler DC_molor_subsystem 


图 9.6.17 添加 数据 类 型 转换 模块 
再 次 运行 这 项 任务 , 变 为 了 警告 ,如 图 9. 6. 18 所 示 。 单 击 Modify All 按钮 改 为 系统 建议 的 定 标 


方案 。 
ReESUIt : 让 Warning Explore Result. -|] 










Conmtrol SOnal InpUI 





Speed Control Signal Scope 


Fixad-Point data trpe 5caling 25 Tecocmanded For the Sigdlinxk blocKks in thg 全 
Followinz +sble，3eforye applying the TecOzmendation or 5peciEy desixzed F 
scaluing，xconsidear SaVvinEg 号 ITe5tore point . 


Recommended Data TyYDPe Summar7 了 








间 1ock Eurrent |Recomnended | Ri2081E 

,了 PIPE double Fixat1l 32, 323) Fonverted U5EnE inPUt | 
共 catzollsxy/ Sus : Parazseter ord leargth and -者 
jatpaxt ] in maz values; OverfTIow 5 | 
| hot possibie basad on zinrmax | 

|] | Fange | 
LED 下 doubIe Eee 1 32, 23》 Fonverted usEine inpat 
论 CntYcl1lexy In1 Parameter wd TanmEgth and as 
my mm rm 天 mrrTmETrmaen 一 
由 C 廊 斌 GPL 


AppP17 al Yeported YecOzmerndations- 


Modify Ali3 


图 9.6.18 数据 类 型 及 定 标 任 务 页 面 


(8) 执行 到 4. 2 项 Identify questionable fixed-point operations 时 ,出现 警 告 , 如 图 9.6. 19 
所 示 。 这 项 警告 是 关于 定 标 后 数据 运算 的 定 标 规 则 的 ,可 以 在 Fixed-Point Tool 中 对 其 作 进 
一 步 修改 。 


Resulit: 心 Warnins [sxplore asult ， 





The foLllowing blocks TeQuiye VET7 CUDPGT5OgG DuUlItipiication， The fi7st Input 
hag 32 batsg、 The gecond input ha5s 32 bits5，、Tbe ideal prcduct has 64 bits、The 
1arge5t zintagar 57z6 For thE target has DOnly 32 bit5、The Yelative SCaLIEnE CE 
the inputs5 and the Output >xeaaizes that 5Doe Dt the 32 ost 2aIEBmIEICan《 bzta of 
the ideal product be detersined in the C ccde、The CC ccde YesQuiTad tc da thag 
sulitipiication 25 iarge and 51cor、For this target，Yestricting TDUITSDP1CRT IORE 
tD 16 bits tipes 36 bitg 2 Strongly7 Y6cc2208nd6H 





Thea following 5uns biocks have an input Tith aa 510pe Edjustzent Factor that dces 
not equal the Eliope adjustzent factor cf the Dutpat，The 5nput ha5 51CDPE 
adjustzment factor .28 The oatpuat has 5lcpe adjustoent factor 1I、The net Slope 
5djustpent facteoyr ts TI. 28、 This 了 isazatch Teqauires the Sum DIcoK YYC amDIOF7 CnE 7 
zcre DuUitipliicaticn Dperatizons， TO YeDoOVve te 25EStCh， CRERBEE 七 二 七 己 丰 了 总 二 玉 全 
that the inputs butput， and accuztiatcr alLl have +the 5a2E6 510ps adju5stmcnt 
Eactecr- 


DCE_ MoToR abd/ FID contzpizl 





图 9.6.19 存疑 的 定点 化 处 理 任 务 界面 
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事实 上 , 若 要 得 到 更 为 精确 的 定 标 方案 ,还 需要 为 PID Controller 模块 的 内 部 参数 作 定 点 
化 处 理 。 打开 该 模块 的 Bata Types 界面 ,将 数据 类 型 预 设 为 有 符号 32 位 定点 数 , 待 Fixed- 
point Tool 对 其 优化 调整 ,如 图 9. 6. 20 所 示 。 


1 一 一 一 一 
| ain | PID Advanced | Data I7pes | State Attributes | 


| Data Type 人 
| parameter: fixdat (1, 32, 16) w [> 

| IT parameter; fixdt (1, 32, 16) ~ | >> |] 

IP product output : fixdt (1, 32, 16) 到 [zj 

| I product output : fixdt (1l, 32, 16) 一 [>> 

| Jrtegrator output : fixdt (1, 32, 16) 四 22 

| Sum output : fixdt (1, 32， 16) w 可 > 涌 

| aceumlator of Sunmi: fixdt (1 32, 16) 时 [> 

| saturat ion output : fixdt (1, 32, 16) 于 [> 


上 


多 


图 9. 6. 20 ”PID Controller 模块 内 部 参数 定点 化 


0.060.2 下 ixed Point Tools 


利用 Fixed-Point Advisor 工具 自动 定 标 后 , 需 进 一 步 优 化 定 标 , 此 时 需 用 到 Fixed-Point 
Tool 工具 。 在 PID Controller 子 系统 上 右 击 ,选择 Tool->Fixed-Point-~Fixed-Point Tool 选 
项 ,打开 图 9. 6. 21 所 示 界 面 。 
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9.6.21 Fixed-Point Tool 界面 


1. 记录 定点 / 浮 点 仿真 数据 5muotion Yew_ jpok Hep 
凰 Exchange Ac6ve and Reference Resuits 
单 击 Results 菜单 ,分 别 选 择 Clear Active Results 二 
和 Clear Reference Results 命令 ,如 图 9. 6. 22 所 示 。 这 砚 “Move heference Results 忆 Active 
两 项 可 完全 清除 之 前 运行 Fixed_Point Advisor 时 保存 的 
数据 ,以便 Fixed-Point Tool 生成 一 组 新 的 数据 ,进行 优 
化 定 标 工作 。 图 9.6.22 清除 Active/Reference 数据 


ss 
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(1) 记录 浮 点 仿真 数据 。 在 Fixed-point instrumentation mode 中 选择 Minimums,maximums 
and overflows 选项 , 即 在 适 算 过 程 中 记录 变量 的 最 大 值 、. 最 小 值 和 溢出 次 数 。 在 Data type over- 
ride 中 选择 Double 选项 , 即 在 运算 过 程 中 运用 浮 点 数 , 然 后 按 下 按钮 外 |, 如 图 9. 6. 23 所 示 。 


Pixed-point instzuentaticon 3c0d6: 


[inimuma, aeahaaame nd _awey lowg | 






Data t7pe COVeazTide- Data t+7Pe Overzyide applies 《01: 


Esc 





了] /ak sumerie tmes 








Gverwrite 0OT 醒 EFEE 有 0Od 检 上 再 大 个 F 天 后盾 娘 束 


CQversrite 





图 9.6.23 记录 浮 点 仿真 数据 
运行 后 ,得 到 变量 的 数据 ,如 图 9. 6. 24 所 示 。 显 然 ,在 使 用 浮 点 数 时 不 会 发 生 溢出 。 


Name Run SimDT specfiedDr 





LUveriowwWrap 和 Accept DeognMin WmMin 


图 9.6.24 浮 点 数 无 滋 出 


选择 Exchange Active and Reference results ,将 仿真 结果 保存 为 参考 数据 (Reference) ,如 
图 9. 6. 25 所 示 。 


ResdltEs 


合 Show autoscale infozmasticon for 5elected TesUlt 





图 9.6.25S 将 数据 转换 为 Reference 类 型 


(2) 记录 定点 仿真 数据 。 在 Data type override 
中 选择 Use Local Setting 选项 , 即 在 运算 过 程 中 运 
用 现 有 定 标 方案 ,然后 单 击 按钮 氏 |, 如 图 9. 6. 26 


Siaulation 5ettinegE 





起 | un sisulataon and 5tDFR 大 CTTR 工 GREAT 妇 于 
一 







Ftxed-potnt inst7uoaentatton 320d6- 








[air eerteees oa orertlors >] 所 示 。 
nn 运行 后 ,得 到 变量 的 数据 ,如 图 9. 6. 27 所 示 。 
RE 每 个 变量 都 有 Active 和 Reference 两 组 数据 , 标 为 
ee 一 一 一 Active 属性 的 是 定点 数据 。 可 看 到 OverflowWraps 
栏 没有 值 , 即 在 运算 过 程 中 没有 数据 溢出 ,这 说 明 自 
图 9.6.26 记录 定点 仿真 数据 动 定 标的 结果 正确 。 
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Name Run SimDT 
外 In1 7 
靖 Int 
| 和 ma2 
| 开 mz 
|E PD .-， 
所 Pp - tiVe 
| 吉 piID .Rs 
已 PD-， Actve 
[1 PD -天 
| 忆 PD .ace 
| PD .Rs 
| 喇 PID .，s2; 
已 PID ..，FE 
| 局 pPD_. :- 
| 蕊 PLD . 
马 Pr -. 
已 sum 
* | 辣 Sum.， 
| 于 Sum 
了 Sum. 


SpecifiedD7 





图 9.6.27 定点 数 无 浇 出 


2. 优化 定 标 


分 别 得 到 定点 / 浮 点 两 组 数据 后 ,可 以 方便 地 观察 定点 化 所 带 来 的 误差 。 以 Sum 模块 为 
” 例 , 右 击 Sum, 在 菜单 中 选择 Time Series Difference(A-R)Plot ,命令 如 图 9.6. 28 所 示 ,绘制 出 


两 组 Sum 信和 号 的 误差 曲线 。 


Sum 信和 号 的 误差 曲 线 如 图 9. 6. 29 所 示 ,在 PID Controller/Sum 中 ,Active 和 Reference 
两 条 曲线 基本 重合 ;Difference between Active and Reference Runs 中 的 曲线 则 描述 了 在 两 条 
曲线 在 每 个 时 间 点 处 的 误 关 值 ,可 见 最 大 误差 为 1.2X10 -左右 。 





芝 %m 于 Sove Achve Resul 芭 Reference 
已 wm Ciea Acive Reeults 
世 So Clear Referrrce Result 


图 9.6.28 绘制 误差 曲线 


如 果 用 户 对 Fixed-Point Advisor 自动 证 标 
的 误差 情况 并 不 满意 ,可 以 单 击 Propose 
fraction lengths 按钮 ,让 Fixed-Point Tpol 设计 
出 一 个 更 加 优化 的 定 标 方案 , 若 用 户 认 为 该 方 
案 可 接受 , 则 单 击 Apply accepted fraction 





PID CemlrollewSum 


3 36e+009 


一 一 一 Actve 
Reference | 16680089 


图 9.6.29 误差 曲线 


AHtDESCSELTETE 
[ 雪 ] Prcpose frsction engths 


| | 


| mo 二 PP17 acocepted fraction LenEthE 





9.6.30 系统 推荐 定 标 按钮 


-人 





基于 模型 的 设计 一 MCU 篇 


lengths 按钮 ,应 用 此 定 标 方案 ,如 图 9. 6. 30 所 示 。 
修改 完毕 后 即 可 发 现 ,Axtive 属性 的 模块 的 定 标 方案 已 变化 ,如 图 9. 6. 31 所 示 。 


Name Run Simpr 
[和 In1i 
[名 Inl 
I 和 In2 
] 攻 im2 
妆 pipD .FE 
马 PT. 
马 PID 
马 pD 
马 PID 
局 pPID 
也 pPID 
妆 pip 
妆 PIc . 
要 pm - 
忆 PID 
也 PID 
PiD 
世 PpPI - 
蕊 Sum.- 
杞 Sum 
和 Sum 
总 Surm 上 Active 


OverflowWraps 





图 9.6.31 应 用 系统 推荐 定 标 
此 时 重复 “1. 记录 和 定点 / 浮 点 仿真 数据 ”的 工作 ,并 再 次 绘制 Sum 模块 的 误差 曲线 如 图 
9. 6. 32 所 示 。 可 见 两 条 曲线 几乎 完全 重合 ,误差 的 峰值 为 3.5X10 一 左右 ,精度 比 优化 前 提高 
了 两 个 数量 级 。 


PiD ControllerSum 






Reference 





Real World Value 


Real World Value 


图 9.6.32 误差 曲线 


运行 定点 化 模型 ,其 仿真 结果 如 图 9. 6. 33 所 示 。 与 未 作 定 点 化 处 理 的 模型 仿真 曲线 相 比 ,几乎 
完全 一 致 ,这 再 次 证 明了 Fixed-Point Advisor/Tpol 的 定 标 是 合理 的 ,误差 控制 性 能 良好 。 
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图 9.6.33 仿真 曲线 


9.7 软件 在 环 测试 


软件 在 环 测 试 是 对 模型 生成 的 嵌 人 式 C 代码 进行 测试 。 即 在 模型 环境 中 对 被 控 对 象 模 
型 生成 的 代码 进行 非 实 时 性 检查 ,以 评估 生成 代码 的 优 劣 ,完成 对 模型 设计 的 早期 验证 。 

下 面 对 PID Controller 子 系统 作 软 件 在 环 测试 。 

(1) 在 一 个 新 模型 中 将 PID Controller 子 系统 独立 出 来 ,用 输入 /输出 模块 连接 到 子 系统 
如 图 9.7. 1 所 示 。 


[和 in? 
ou 疙 器 
[人 in2 Cut1 
tn2 


PIC Cocntroller 
好 9.7.1 PID Controller 子 系统 


由 于 PID Controller 子 系统 已 做 过 定点 化 处 理 ,输入 /输出 端口 的 数据 类 型 也 要 作 相 应 调 
整 。 根 据 定 标 方案 ,把 Inl .In2 模块 的 数据 类 型 设 为 fixtd(1,32,23), 把 Outl 模块 的 数据 类 
型 设 为 fixtd(1,32,20) 。 

(2) 选择 Simulation~>Configutation Parameters, 打开 模型 的 参数 设置 对 话 框 ,在 solver 
列表 框 选 择 定 步 长 离散 求解 器 ,如 图 9. 7. 2 所 示 。 


Solver optiors 





Type: [Fixed-step ns wa Solver: | discrete (no continuous_states) 本 





Fixed-step size (fundamental sanmplLe tine): auto 


图 9.7.2 求解 器 设置 
在 Real-Time Workshop 界面 选择 ert. tlc 选项 ,如 图 9.7. 3 所 示 。 


Target SelectIion 
Syste 朋 target file: ert.t1lc | rowse.。。 
Language: [c ea 站 


人 ee 


Description: Real-Time Workshop Enabedded Coder 








图 9.7.3 设置 tlc 





在 Real-Time Workshop-~>SIL or PIL Verification 页 面 选择 SIL 选项 ,如 图 9.7.4 所 示 。 


Software-irr-the-1loop (SIL) and processor-inr-the-1oop (PIL) verification 
多 Erable portable word sizes 


SIL or PIL verification block 


Create block: |SIL 








Code coveIage 


Code coVerage Tt001: 玉 iD = Corfigure Coweraepae 。。。 


图 9%.7.4 设置 SlL 


(3) 保存 设置 后 单 击 名 按钮 生成 SIL 模块 。 用 生成 的 SIL 模块 替换 原 模型 中 的 PID Con- 
troller 模块 ,实现 软件 在 环 测试 ,如 图 9.7.5 所 示 。 









PID Controller Output 


DC motor_Subsystem 





Speed Control Signal 


9.7.5 SIL 验证 模型 


仿真 结果 如 图 9. 7.6 所 示 ,仿真 波形 与 PID Controller 控制 下 的 响应 相同 ,说 明 它 们 实现 
的 功能 一 致 , 即 生成 的 代码 能 实现 模型 的 功能 。 





图 9.7.6 仿真 波形 


9.8 代码 跟踪 


需求 与 模型 间 可 建立 双向 跟踪 ,代码 与 模型 同样 也 可 以 建立 这 样 的 跟踪 ,用 户 可 以 通过 代 
码 与 模型 间 的 链接 ,快速 定位 某 个 模块 所 对 应 的 代码 段 , 也 可 以 通过 分 析 人 代码, 改进 模型 。 
右 击 PID Controller 子 系统 ,选择 subsystem parameters 选项 ,在 弹出 的 对 话 框 中 选择 Teat as 


。 .470 
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atomic unit 选项 ,将 子 系统 原子 化 ,如 图 9. 8. 1 所 示 。 关 于 原子 化 的 问题 在 9. 9 节 介 绍 。 








| Subsystem 


驶 Funcbion Bioccx Parameters: PID Controller 


| Select the setting3 foOr the subs7stem bb10cK。 


| Parameter3 
Show port labels FroaPortIcon 0 3 
Read/Write Pernissiors:t | ReadWrite 宙 隐 | 


Name of error callback function: 


Permit hierarchical resolutiorni ,上 1 
yj Treat a3 atORLIC UVIT 
Jininmlize 31gcbraic ]0op occurrences 
Sanple +ine (-1L for inherited) ; 
一 


FKeal-Time orkshop 57stena code: Auto 四 







地 


9.8.1 模型 原子 化 


在 参数 设置 对 话 框 的 Report 页 面 , 按 图 9. 8. 2 所 示 进 行 设置 , 则 在 编译 模型 时 目 动 打开 
代码 生成 的 报告 ,并 建立 模型 与 代码 间 的 双向 关联 。 


忆 | Create code generation report yi Launch report automaticall1y 
Navigat1lon 
辟 Code~tor-node1l 


民 Model-to-ccde Configure... 


Traceabllity Report Contents 

局 Eliminated /virtual blocks 

必 Traceable Siaulirik blocks 

懈 Traceable Stateflow objects 

局 Traceable Enbedded UTLAB functions 


图 9.8.2 报告 设置 页 面 


单 击 按钮 见 编译 后 自动 弹出 代码 生成 报告 ,在 模型 中 右 击 PID Controller 子 系统 ,选择 
Real-Time Workshop->Navigate to code 即 可 连接 到 对 应 的 代码 段 , 如 图 9. 8. 3 所 示 。 


可 PID Cordroller 


















2 起 SJPS 记 芳 7 


* Duzfpilts FF BfonIC 3 Dot3pTD ContzoTTRr 2 
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FE 3zSCzefeEnfezrat 





所 放 2? 7 可 Permm 人 7 am 
1 》< Oport ns 2 


Dotpartfr “cooz nzt 












图 9.8.3 模块 与 代码 间 的 双 相 跟 踪 (PID Controller) 


本 9 基于 模型 的 设计 一 一 MCDU 篇 


单 击 代码 中 的 链接 同样 可 以 定位 到 响应 的 模块 ,如 图 9. 8.4 所 示 。 


oul CD 








2 北 TDPOrt: op 3 
1 可 外 
7 test 了 .Sum = test_ U. Inl 一 test U. In2 
了 Stat 《2 SUEO8EOn ”Inc 
3 六 下 75CTeFTTTIFECEYSYOT S227TDfeepstce 
只 下 二 2 放下 1 
并 ) 中 生 





图 9.8.4 模块 与 代码 间 的 双 相 超 踪 (In2) 


为 了 增加 生成 代码 的 可 读 性 ,还 可 以 对 某 一 模块 进行 描述 。 例 如 对 PID Controller 子 系统 进行 
描述 , 右 击 该 模块 ,选择 菜单 项 Block Properties, 在 对 话 框 的 Description 栏 输 入 :This block can pro- 
duce the PID control signal from the error of actual and demand speed, 如 图 9. 8. 5 所 示 。 


固 Block Properties:PID Controlier 












| General | Block Annotation | Calbacks 


| Usage 
| Description Text saved wah the block mn the model fie 
Priority: Specrfies the biocks order of execution relative to other bcks 站 
| 由 he same model 
| Ta9' Text that appears mn the block iabelthalt Senulnk Denerales 






|| Descrnpton 
1 

| The blocx can pfoduce the PD conirol sional from the error 0f actual 
| and demand speed| 





图 9.8.5 模块 描述 


在 参数 设置 对 话 框 的 Comments 页 面 上 , 匀 选 Simulink block descriptions 复 选 框 , 则 对 
模块 的 描述 会 作为 注释 显示 在 对 应 生成 的 代码 中 ,如 图 9. 8.6 所 示 。 
Custom commerntS 
和 鲍 | Simulink block descriptions 门 Stateflow object descriptions 


占 ] Simmulink data object descriptions 门 Requirements in block comments 
加 Custom commerts (PT objects only) 加 MATLAB function help teyxt 


图 9.8.6 Comments 页 面 
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单 击 按钮 山 此 成 代码 ,自动 打开 代码 报告 。 在 模型 中 右 击 PID Controller 模块 ,在 弹出 的 
菜单 中 选择 Real-Time Workshop 一 Navigate to Code 命令 ,就 跟踪 到 该 模块 对 应 的 代码 ,如 


9. 8.7 所 示 ,可 看 到 对 模块 的 描述 显示 在 代码 中 。 


wu CitPots Yor afDEIC SpbSysfeR (Roof Contro 了 er 
For (Toot》 DID 7 





图 9.8.7 模块 注释 


9.9 ”代码 优化 及 代码 生成 


9.9.1 子 系统 原子 化 


子 系统 模块 可 分 为 虚拟 子 系统 或 非 虚拟 子 系统 ,主要 的 不 同 在 于 非 虚 拟 子 系统 在 执行 仿 
真 时 ,是 被 看 作 一 个 单元 ,节省 了 大 量 用 于 中 间 变 量 的 存储 器 。 而 虚拟 子 系统 ,只 是 在 视觉 上 
简化 了 模型 。 将 各 个 功能 模块 合并 成 一 个 非 虚 拟 子 系统 ,可 提高 代码 执行 效率 。 

用 户 也 可 以 在 添加 子 系 统 模块 时 ,直接 添加 Ports & Subsystems 子 库 里 的 Atomic Sub- 
system 模块 ,然后 把 需要 创建 子 系统 的 模块 拖 人 Atomic Subsystem 模块 ,如 图 9. 9. 1 所 示 。 
它 与 Subsystem 模块 的 差别 在 于 ,前 者 默认 启用 了 Treat as atomic unit 选项 。 从 外 观 上 看 ， 
启用 了 Treat as atomic unit 选项 的 子 系统 模块 ,边框 加 粗 了 。 


= 副 Samuiink 
Commonly Used Blocks 


-Continuous 
:DECcontindaies In1 Out1 才 
D 上 crete 


| “Logic and 日 上 口 perathons 
| 1- Lookup 隐 bles 

j 则 ath Operabons 

| Wodel Verification 

1 .ModeLWide Utilties 


yi 人 
| 二 SignaiAttributes v ER = 一 一 一- 
图 9.9.1 子 系统 模块 


选中 模型 菜单 项 Format 一 Block Displays -~ Sorted Order ,在 仿真 时 ,用 户 可 以 从 模块 
右上 角 的 数字 看 出 ,虚拟 子 系统 模块 与 非 虚 拟 子 系统 模块 在 执行 过 程 中 的 差别 。 设 置 为 原子 
化 子 系统 之 前 ,模型 标号 如 图 9. 9. 2 所 示 。 


Atornic Subsystern 


攻 和 | 
(135 | 
Out1 
In2 PiID Controjler 


图 9.9.2 虚拟 子 系统 








“gg 了 基于 模型 的 设计 一 一 MCU 篇 
设 为 原子 化 子 系统 之 后 ,模型 标号 如 图 9. 9. 3 所 示 。 





In2 PID Controller 


图 9.9.3 原子 化 子 系 统 


9.9.2 确定 芯片 类 型 


执行 Model Advisor 检查 时 ,根据 Check the hardware implementation 检查 项 的 提示 ,如 
果 用 户 需 要 生成 针对 具体 芯片 的 代码 , 则 需要 在 模型 参数 配置 窗口 指定 硬件 类 型 .TLC 文件 、 
芯片 库 文 件 ,如 图 9.9.4 所 示 。 


4 vicdel Advisor 
站 jy ByProduct 
如 Simulnk 
a 1 遂 Real-Time Workshop Embedded Coder 
过 各 Check sclver ior code generation 


v) 4 Check the hardware 本 


questlonable 50ffware envIironment specifcations 
yi 外 jdentify questicnable code instrurmentastion 1data IO) 
司 可 check for blocks that have constraints on tunable parameters 
骨 入 Checkforblocks not recommended for MISRA-C:2004 compllance 
司 生 check configuraticn parameters fcr MISRA-C-2004 compliance 





侠 Check for model reference configuration mismatch 
十 “identify blocks that generate expensive saturation and rounding code 
名 “check sample times and tasking mode 
多 ^identify questionable subsystem settings 
崩 改 "identify qutstionable fhxed-point opPeraticns 

本 避 SimoulinkVenfcation and Validation 

yj LN Simulink Control Design 
属 1 8y 休 5Kk 


图 9.9.4 Model Advisor 任务 树 
在 模型 参数 配置 窗口 的 hardware implementation 部 分 ， 指定 硬件 交 型 ， 如 图 9. 9.5 所 示 


Device vendor: AR Compatible Eee -了 Device type [AR We 人 | 
卫 smber of bits Largast at0aiC IEZG 
Char: 8 Shorti 16 nt: 32 
2 SSSF: we 
1ong: 32 10at: 32 double: ;64 
floating~point: Elstg 
Iativwe: 32 pointer: 32 9 ee 
Byte ordasringi [Little _Endian al Eee 0 ne] Signed integer division rounds 不 Of [undatined 了 


加 Shift right on a signed integer 83 arithnetIc Shait 


图 9%.9.5 指定 硬件 类 型 
在 模型 参数 配置 窗口 的 Real-Time Workshop 部 分 ,设置 TLC 文件 为 ert tlc, 如 图 9. 9. 6 所 示 。 


Target Selection 


System target file: ert.tlc 本 ES [Browse. 


Language: [ws Pi 2 








Descriptiorn: Real 一 -Ta Sa Embedded Coder 


图 9.9.6 指定 TLC 文件 
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9.9.3 代码 检查 


在 生成 代码 之 前 ,用 户 还 可 以 根据 项 目的 要 求 , 选 择 代码 生成 的 目标 ,然后 执行 Code 
Generation Advisor 检查 ,根据 建议 进行 修改 ,以 改进 代码 ,尽量 符合 用 户 选 定 的 目标 。 


1. 选择 代码 生成 目标 


上 一 节 已 经 设置 了 基于 ert 的 TLC 文件 ,之 后 在 Real-Time Workshop 设置 页 面 的 下 半 
部 , 单 击 Set objectives. . . 按钮 ,选择 代码 生成 目标 ,如 图 9. 9.7 所 示 。 


Code CerneratIion 上 Adv1sor 
Prioritized objectives: Unspecified Set objectives ssiei| 
Check nodel before generatlng code: [oft 拉 |_Check podel .,， ] 


请 |] Cenerate code only TS ] 














图 9.9.7 模型 参数 配置 窗口 


单 击 左 箭头 按钮 ,将 左 侧 窗 口 的 目标 添加 到 右 侧 窗口 ,或 单 击 右 箭头 按钮 删除 已 添加 的 目标 。 


根据 重要 性 单 击 上 下 箭头 按钮 ,在 右 侧 窗口 ,将 选中 的 各 目标 排序 ,如 图 9. 9. 8 所 示 。 代 
码 目标 及 意义 如 表 9. 9. 1 所 列 。 





列 Set Objectives - Code Generation Advisor 










Description 
Select and priorit1lze 7OUr code generat1lon objectiVes。Tou can add cuUstom 
objectiVves，for detalls，sSee the docunentat ioru 


Available objectiVves 


Selected objectivVes -~ prioritized 








RON efficiency 
RAN efficiency 









| Traceabllity 
Safety precaution | 
Debugging | 
国 人 人 本 7 
| [ok -|] [cancel ] Help | 


图 9.9.8 选择 代码 生成 目标 
表 9.9.1 代码 目标 及 意义 


Execution efficiency 提高 执行 效率 | RoM sttieieney 减少 ROM 使 腹 以 及 执行 时 间 


RAM 
Safety precaution ee 调试 代码 生成 过 程 


光 基于 模型 的 设计 一 一 MCU 篇 


2，Code Generation Advisor 检查 


(1) 本 例 选 中 代码 目标 为 Execution efficiency、ROM efficiency、RAM efficiency 与 Traceability ; 
(2) 单 击 Check model. . . 按钮 ,如 图 9. 9. 9 所 示 。 





Prioritized objectrves: Effhaency, Taceabaity 邓 Setobjectives 


Check model before generating code: Of 他 





Yi Generate code cnly 


9. 9.9 Code Generation Advisor 检查 


(3) 在 系统 选择 窗口 ,选中 整个 模型 ,而 不 是 某 个 子 系统 ,确定 后 开始 Code Generation 
Advisor 检查 ,如 图 9. 9. 10 所 示 。 


列 | System Selector 











9.9. 10 System Selector 界面 


(4) 运行 Advisor 后 ,出 现 部 分 警告 项 ,例如 ,check model configuration settings against 


code generation objectives 项 , 列 出 部 分 未 优化 的 参数 ,可 通过 底部 的 Modify Parameters 按钮 
自动 修改 ,如 图 9. 9. 11 所 示 。 


Check model confiEguration Fettings 2Eatnst code Eeeneratton objectives 


Te followang ParaO2tGY Ta LE TS Root ptiBized for tha 5619c569 0bjactives:I Bzacotacm 
eficxenc7，RCM fficiency，RAMN 4553538Pc7， TYaclabIlzt7 


Te autoeaticaliy fx 《he WEIRIRE， CIK 《be ”Modif7T FRIES8t6TS uttDT md 娘 昌 本 站 荆 划 TCD 二 为 和 
SEECX、 TO SU&ULI7 2 《he FErErE cc 《the PE7U24V 6 FDIEPK SO 0p6R he 

克昌 下 证 了 症 作 三 后 乓 已 关节 入 全 丰 丰 作坊 O3， nd SET7 和 DPIY 必 E 了 村 CCEOE 和 站 间隔 YE 二 人 

opjecttves: EXEcUeLOR Exzcienc7 ROOM strzecienc7，RAMX EeeteTnc7 TBCeRDL ES 


Parmmeter Furreat Vaioe 泵 ecommended Vaioe ) 
ESzRxsaE- jp zz 
n 了 

全 Rr | 

二 了 ] IOFR | 

| 

RE Fn 时 

ft cn | 





闪 雪 EC 


Change COUT77ent 8LIU8E tb TcOetnded ve， SOme Da7A26teT5S Sieht 760076 3380U 人 Ch 和 人 放 让 攻 
eaatr Paremetera| 
图 9.9.11 针对 代码 生成 目标 的 模型 设置 检查 任务 页 面 


(5) 修改 后 右 击 在 顶层 目录 Code Generation Objectives 选择 Run Selected Checks 命令 ， 
则 与 电 相 关 的 一 些 警 告 也 一 并 解决 了 。 在 Check the Hardware Implementation 警告 项 中 提 
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示 要 指定 取 整 方式 ,如 图 9. 9. 12 所 示 。 用 户 可 单 击 链接 Signed integer division rounding，, 在 
参数 设置 的 Hardware Implementation 界面 将 取 整 方式 设 为 zero。 


Restdlt- 丰 Waynineg 

Chbheck ”Byte ordering” and ”Siened integer division rounds 上 DOD” ParameterE 
TIdentify incongsistencies Cr Underspeciftication Of hardware attributes that can Tead tc 
zincoxrxpct and ineffticisnt ESnsratsd oocde， 


训 羡 天上 人 区 


You have not 5pecified SEEnSd intSESE Hivi5iGn IOURd3DS， 


和 ecommaended Actioc 
5Specifr Signed inctegsz divisziocn Tounding tc ensure COFTect code BeneTation for th 二 


FTEet 卫 6TdwayE. 


Checkxk whether ”Embedded hardware ” and ”Balation bardheare” matchb 
Tdentif7y whether “None ”35 selected zcor "FEzuzaticn hardyare TIE "None” 55 Cleared， 
identif7y whethezr tarEet EPecificaticons5 uEtch- 





尸 志 三 翅 人生 
“None ”ii5 seliected for ”"Emulatidon hardware ”or None is Cleared and the tareet 


图 9.9.12 检查 硬件 设置 任务 界面 


(6) Identify questionable code instrumentation 警告 项 中 提示 测试 点 会 影响 代码 优化 的 
效果 ,如 图 9. 9. 13 所 示 。 


Result : 全 Warning 





The following biocks have One Or Dore Cutput sgnals 5pecified as 七 est PocointEs.、This 
reQuires gl1obal zemory and ii5 not optiasal For production code Eeneration. 
FOT Bore etfticient code，Y7YOU Can either: 
sa Individualiiy disable each test Point by cleazing the Test point check boxz in the 
Signal Properties disalog box. 


es IEnore all test points5 duzing code BEeneTration b7 5electing the IEnore test point 
ERalE checx box， 


testPID ContzolIerzyInl， 
tegt7EID CeatzetllszyIn2， 


"PT 






entTcl1l 





图 9.9.13 存疑 的 代码 工具 任务 界面 


用 户 可 单 击 链接 test/PID Contoller/Inl ， 一 
定位 到 含 测试 点 的 信号 线 ,在 右键 菜单 中 选择 | “heoamegeggW 
Signal Properties 命令 ,如 图 9. 9. 14 所 示 , 取 
消 勾 选 test point 复 选 框 。In2 .Sum 的 信号 线 Linearizabon Points 
也 做 同样 处 理 。 


(7) Identify blocks that generate expen- 





sive saturation and rounding codes 警告 项 提 
示 说 ,当前 设置 会 在 代码 中 产生 与 整数 除法 相 
关 的 宛 余 ,但 可 以 起 到 保护 算法 中 可 能 出 现 的 
分 母 为 0 等 意外 状况 ,如 图 9. 9. 15 所 示 。 用 户 可 根据 自己 的 需要 判断 是 否 需 要 这 些 宛 余 的 保 
护 措施 。 


图 9.9.14 设置 信号 属性 


醒 3 基于 模型 的 设计 一 MCU 篇 


Raesult 心 warrnine 


InteBgexr dviszcon generated ccdea TILI DonEaIR PITOtECZITOR 古 E 3EnEt az7IthzaetzCc eeDPt ECOFE 
Ze diviasion br ze76。 INI_ XINW iand LONC_ XIN -IDepending cn 《he bazdwra7e 
arEthaetac ezcaptzons 5an cas za2atzc behavioz，50 PITOEEC 直 ERE 而 蕊 大 主人 T 环 帮 世 站 丰 5 生 
aeepYeEOnE c6R be czitical，Scoe desieznez5s SonetzVct +t*hersy 2c0dels in an EXEtTESELIT 
caEzefuI wa7 that 2ake5 zt i2po5sible for excepticon *zzEEEBeZEnE input Gocoabinastions AtD 
FS5hR Edivision opergstaionr、 For these Pocdels5，t+the pxrptection GDde 古人 太古 人 二 Ta 上 过 
the diva6icon Opezratzion 35 Tedundant。 is 7edundant Przotectacn 5ode an De Ze20OV6 
WEang the zx6dG-posnt dsvi5sscn 59tt2ng 5 《he pta2538320n panpes De hs CongzEurat5cP 加 
FAT 0 5 hoold cn17 be done hen 7U have Pen8taxneL7 VTSd 信 h85 
Your 3cde1l 5ann5t ca xceptdicn5 :0 dvY38500 02638350nS 








CecX zc7 blocX56 《hat 5087EtSE 6xPpansive 7rodunding 55d6 


图 9.9.15 确认 生成 大 量 亿 和 、 取 再 代码 的 模块 任务 界面 
(8) Identify questiona fixed-point operations 警告 项 提示 说 定点 数 的 乘法 应 遵循 一 定 的 


规则 ,如 图 9. 9. 16 所 示 。 例 如 两 个 32 位 定点 数 相 乘 的 结果 只 有 用 64 位 定点 数 表 示 才 能 保证 
不 发 生 溢出 错误 ,根据 9 5 节 " 定 点 模型 ?得 出 的 结论 ,输出 的 结果 仍然 用 32 位 表示 ,因此 该 项 
检查 认为 可 能 会 出 现 问题 。 而 实际 上 ,在 Fixed Point Tool 中 已 经 验证 了 32 位 定点 数 在 本 模 


型 中 是 不 会 产生 溢出 的 ,所 以 这 项 警告 可 不 用 理会 。 


一 -一 一 一 一 一 -一 一 一 一 一 一 一 一 人 


Resuit- 态 Warnirg |Ezplore Kesult. .| 
人 ww www 一 wmatreereer err 一 一 


The faollowinEg blocks YeQtdire Ba veT7y Cyberscoe Dultiplicaticn，]he fi7st input has 32 
bzts，The sseconrd input has 32 bit5. The idessal product ha5s 64 bits5s，The 1a7EESE6t nteEex 
sze for the targsst has cnl7 32 bits，The TYelative 5calang of the inputs and the cutPUt 
YsQqauiress that 5c2ce of the 32 0st significant bits cf the ideal Product be deterained in 
the CC code、 Tha < ccode YeQquzirzed tc do this zultiplicatiocon 5 1a7gEe and 5lcow，For thi5 
target，Ys5triotIng zuULtiplzicaticons tc 16 bit5 tioes 16 bit5 25 5t7OnEI7 TeCOamended- 
CoRntzrollex PIPE 


:FID 








图 9.9.16 确认 存疑 的 定点 化 处 理 任 务 界面 


9.9.4 代码 生成 


在 代码 生成 之 前 ,需要 考虑 到 在 ARM 上 实现 ,将 输入 端口 的 数据 类 型 设 为 int32 ,输出 端 


口 的 数据 类 型 设 为 uint32。 相 应 地 ,需要 添加 数据 类 型 转换 模块 使 之 与 PID Controller 子 系 
统 相 匹配 ,如 图 9. 9. 17 所 示 。 





PID Controller 


图 9.9.17 代码 模型 


,478 。 
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在 参数 设置 界面 的 Hardware Implementation 界面 选择 ARM7 后 , 单 击 按钮 岗 生 成 代 


码 , 并 自动 弹出 报告 ,如 图 9. 9. 18 所 示 。 




















-ae Fe | File: DVIAILAB FILESVWPIDVDC_ wetor_PID AR et TURNVEFY_ main c 
Cortn4s 
DubardsmRSroQG as-Ti9e Ar co rpoproted FF SSE andi 拒 antar PIT 于 
cods_intstfasse RSS 四 
困 站 
Fasaab 南 T ReGOX peal 2 上 n 胞 4 
Ar OhSA03 1 errefed on js 砚 呆 5 有 
Generated Files | 2 2 
(-] Main file “Sret orvetew wp AD 证 玖 启 如 
素 产 全、 Jr eeogioa RE 浊 让 
hj 等 本 mh an .人 msi- 和 产 
[-] Model mles | Eneuked . 如 ac 本 E WP 4 ANY 
和 Ver3eipfji 9 二 PR 
DPKE_mGSOr_PIR_ARM5 5 
RE_metor_PID_ AR | sr 
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| 
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图 9.9.18 代码 生成 报告 


9.10 虚拟 硬件 测试 


在 Proteus ISIS 中 绘制 图 9. 10. 1 所 示 的 原理 图 。 
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9. 10.1 Proteus 原理 图 


本 基于 模型 的 设计 一 一 MCU 篇 


该 原理 图 采用 LPC2124 芯片 实现 对 编码 电动 机 的 PID 控制 。L298 用 于 驱动 电动 机 ; 
74LS386 采集 电动 机 的 输出 脉冲 ,从 而 得 到 电动 机 的 实际 转速 ;P0.0 引 脚 输出 PWM 控制 信 
号 ,可 通过 示波器 观察 输出 波形 ;Logic State 用 来 设 定期 望 的 转速 ,并 由 处 于 上 方 的 数码 管 显 


示 期 望 的 转速 ;下 方 的 数码 管用 以 显示 电动 机 的 实际 转速 。 


需要 说 明 的 是 :PID 控制 器 的 参数 调节 与 具体 的 被 控 对 象 有 关 , 本 章 的 PI 参数 是 根据 第 
2 章 建 立 的 直流 电动 机 模型 确定 的 ,在 实际 应 用 中 ,若是 用 该 算法 控制 一 台 与 模型 响应 特性 相 


符 的 实际 电动 机 ,可 以 达到 很 好 的 控制 效果 。 


由 于 条 件 所 限 ,作者 手中 并 没有 实际 电动 机 ,只 能 在 Proteus 中 虚拟 验证 ,而 Proteus 中 电 
动机 的 建 模 理论 和 参数 设置 作者 也 没有 找到 更 多 可 用 的 资料 ,无 法 针对 Proteus 中 的 电动 机 
建立 一 个 正确 的 Simulink 模型 。 因 此 ,基于 第 2 章 的 电动 机 模型 调节 出 来 的 PI 参数 应 用 到 


Proteus 电动 机 中 ,效果 肯定 不 理想 。 


为 了 解决 此 问题 ,一 个 折 中 的 方法 是 利用 经 验 , 手 动 调节 出 一 个 合适 的 PI 参数 ,然后 在 


Proteus 中 验证 。 
1. 修改 模型 参数 


在 PID 模块 中 手动 将 PI 参数 值 设 置 为 30.0.08, 如 图 9. 10. 2 所 示 。 


| 匠 alm PID Advanced Data Types | State Attributes 
Control1ler settlrgs 
Cortroller ftorm; | Parallel PE 
Proportional (P): 30 


Integral (IT) : 0. 08 


Initazial condit1ions 





3ource: Intermal 











图 9.10.2 设置 P 工 参数 






然后 按照 本 章 介绍 的 方法 对 其 作 验 证 .定点 化 处 理 等 一 系列 基于 模型 设计 的 流程 。 
最 后 ,在 PID 模块 的 PID Advanced 界面 为 PID 输出 添加 上 下 限 ,如 图 9. 10. 3 所 示 。 





[Din ] Pm Advanced | Data Types | State Attributes] 
Output satuUratIion 


届 Limit output 


Upper saturatiorn imit : antiI-windup method: 





5000 none 


Lower saturation 1IIt: 





9.10.3 设置 PID 模块 输出 上 下 限 


7 “480 。 
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2。 生 成 代码 并 建立 Keil 工程 
修改 过 参数 并 经 过 一 系列 优化 、 验 证 后 , 即 可 生成 代码 了 。 在 Keil 中 选择 LPC2124 芯 














BA Source Group 1 
因 StartuP.5 


四 -四 ermainc 





国 一 图 


F 尖 mdl_wide_s532.c 


1 

| 

| 

回 DC_motor_PID_ARM.h 
加 DC_motor_PID_ARIM_pnrvate.h 
轩 DC_metor_PID_ARM_tyPes.h 

| 同 mufs32_ 532_s32_sr29.h 

| 问 mul.s32_s532_s32_sr30.h 

| 国 mul.s32.s32_s32_sr36.h 





| 上司 project | 轮 Bpoxy 
兴 ee 





//#include < stdio.h> 


上 include "DC _motor _PID_ ARM.h" 


上 井 include " rtwtypes.hy 
# include < LPC21xcx. 卫 > 


uint32_T rpmycount = 0; 


void _ irq Eint0TRQCvolid) 


{ count = Count 二 1; 


外- 因 PC_ mctor_ PID_ARMc 


机 . 因 mulLs32_s32_532_sr29.c 
让-` 因 muls32_s32_.532_sr30.c 
轩 mulLs32_s32_532_sr36.c 






















| Re Edt Wew Projed Fash Debug Peripheralg JIoog WCG Window Hp 二 
局 防 加 部. 旺 马 史 党 , 注 站 八 .: 下 2 
上 E 霉 局 豚 藉 路 Targeat : -要 们 | 
ea 和 
已 23 Target 1 “ 001 问 #inciude < sdio .py> 










__iYrq EnEOIRR IVoid) 
COUnLCeCounC1I: 
EXTITINT = GXD2y; 


002 证 incliude "DC mocox_PID RARN PR" w BCdeL 7 3 
003 ; 和 inclaae mztWEVDeS。nn * MatRRozKX 
004 1 才 2mc3lade <LEC21XX.B> 

005 

006 -uint32 T xpm,Ccoanc=0; 

D07 

D08; 

009 


010 | VICVeccRhddz = 0OxGo; 下 5Evzc 寺 新 处 理 荡 
011 1 
012、 
013 void _irq zolivoid) 
014 盖 ; IOCLRO=0x73FF8002; 
015 | IOCLRi=GxFEFFO090: 
06 | xpm = Coanz: 
017 ceung5 二 9; 
018 TOTC=D; 证 对 铬 请 鹤 
TDOIR = CxOFE5; 哑 宁 多 











图 9.10.4 Keil 工程 


由 于 生成 的 代码 仅 能 完成 PID 控制 算法 ,用 户 还 需要 添加 芯片 的 底层 驱动 程序 ,才能 完 
成 整个 代 人 式 应 用 。 打 开 ert. main. c 文件 , 作 以 下 修改 ; 
/# 删 去 该 行 * 7 
/+ 模型 头 文件 * / 
/ *# MathWorks 数据 类 型 * / 


// 外 部 中 断 服 务 程序 


EXTINT = 0x02; // 清除 中 断 标 志 


VICVectaddr = 


void _ irqto(void) 

{ IOCLR0 = 0x7BFF8002; 
IOCLR1 = 0xFFFF0000; 
rpm = Counti 


count = 0; 


0x00; 


// 通知 VIC 中 断 处理 结 束 


// 定 时 器 0 中 断 服务 程序 


aa 
二 ss 

+ 481 9 
四 
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TOTC = 0; // 计 时 器 清 零 
TOIR = 0x0FF; // 清除 中 断 标 志 
VICVectaddr = 0x00; // 中 断 向 量 结束 


void Timer0(void) // 定 时 器 0 初始 化 


{ 


TOTCR = 0x02; // 定时 器 0 复位 

TOPR = 99; //100 分 频 

TOMCR = 0x03;  // 匹配 后 复位 TC, 并 产生 中 断 

TOMR0 = 12500; // 0.1 ss 匹配 值 ,0SC= 12.5M= 12 500 000 
TOIR = 0xFF; // 清除 中 断 标 志 

TOTCR = 0x01; // 启动 定时 器 0 


VICIntSelect = VICIntSelect & (一 (1 << 4)); // 定时 器 0 分 配 为 IRQ 中 断 
VICVectCnt10 = 0x20 | 4; // 定时 器 0 分 配 为 向 基 IRQ 通道 0 

VICVectaddr0 = (uint32_T)t0; // 分 配 中 断 服务 程序 地 址 

VICIntEnable = 1 << 4; // 定时 器 0 中 断 使 能 


void PNMCvoid) /VBPWM 初始 化 


人 


PWMPR = 99; // 分 频 120 

PWMMCR = 0x00000002;// MRO 匹配 TC 时 复位 000 000 000 000 000 000 010 
PWMMRO = 5000; 

PWMMR1 = 200; 

PWMLER = 0x7F; 

PWMPCR = 0x200; // 使 能 PWM1 

PWMTCR = 0x09; V// 使 能 PWM 并 开始 计时 


void ExInt(void) // 外 部 中 断 


人 


EXTMODE = 0x02; // 设置 外 部 中 断 为 低 电 平 触发 

EXTPOLRR = 0x02; 

VICIntSelect = 0 << 15; // 选择 EINTO 为 FIQ 中 断 
VICVectCnt112 = 0x20 | 153 // 将 外 部 中 断 0 分 配给 向 量 中 断 0 
VICVecthddri2 = (uint32_T)Rint0IRO; // 设置 中 断 服 务 程序 地 址 
VICIntEnable = 1 << 15; // 使 能 EINTO 中 断 

EXTINT = 0x02; // 清除 FINTO 中 断 标志 


uint32 _T input, inputL,input2 ,input3; 
void input_PWM(void) // 用 模型 算法 控制 PWM 脉 宽 


{ 


"482 昌 


input1l = (IOPINO&0x4)>> 2|(IOPINO&0x70)>> 3; 
input2 = (IOPINO&0x780)>> 7* 
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input3 = (IOPINO&0x7800)>> 11; 


PWMMR0O = 1000; 
PWMMR1 = (input2x10+input1)x 10; 
PWMLER = 0x7F;i // 使 能 PWMO-PWNM6 匹配 锁 存 


} 

Uint32 _T in; 

vojd rt_OneStep(void) ; 

void rt_OneStep(void) 

{ in = (IOPINO&OxFEFF0)>> 4; 
DC_motor_PID ARM_U. Inl = in; 
DC_motor _PID RARRM U. In2 = ITpmi; 
DC_motor_PID RARM_step(); 
PWMMR0O = 1000; 

/1/PWMMR1 = 999; 
， PWMMR1 = (DC _motor_PID ARM Y,. Out1l); 


PWMLER 0x7F; 


int_ T main(int Targc，const char T * argv[ ])ji 
int_ T main(int_ T argc，const char T * argv[]) 
{ 
DC_motor PID_RRM initialize(); 
PINSEL0O = 0x000000C2 ; 
PINSRIL1 = 0x00000000; // 
PINSEL2 = PINSEL2&0xFFFFFFF3://P1.16-31=GPIO 
IODIR0 = 0xFFFF0001; //P0.16-31 出 1,P0.1-0.15 人 0,P0.0 出 1 
IODIR1 = 0xFEFFF0000; //P1.16-1.31 出 工 
PWM() 
Timer0(); 
RxInt(); 
While(1) 
{ 
It_OneStep(); 


IOSET1 = rpm<< 16; 


} 


单 击 Keil 工具 栏 的 按钮 区 ,或 按 Alt 十 F7 组 合 键 , 在 Output 选项 卡 , 点 选 Create HEX 
File 单 选 按钮 ,如 图 9. 10. 5 所 示 。 

再 单 击 工具 栏 按钮 崖 , 重 编译 工程 (图 9. 10. 6) ,窗口 下 部 的 信息 显示 已 成 功 生 成 HEX 
文件 。 
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Device | Target 0utput | ristinz| User 上 crc++ |] Asm | Linker | Debug | Utilities | 


Select Folderfor Objects... Name of Executzatble: jes 







三 Create Batch Rie 





网 test - bVision4 CE 1 


| File Edit iew Projecd Flash Debug | Peripherals | Tools  SVC5S Window Help 


2 区 三 动 三 | 
1 讽 和 Taxzget : 。 NS 下 
| 】 
| 骨 ertmain< XI 
站 一 revagB6E 琴 了 aa Jr asiaipdhaanmma es __ en 
| 日 -4 Target 1 “ | 078 加 
| 司 寺 3 Source Group 1 079 PNMMRO = 1090)， 
| 080 BEWMRI = 3; 
| 生 
本 | 081 ENMMR1 = 1DC motor BID RMRM Y.Oat1) ; 
二 | 区 DC_moter_PID _ ARM.c | 062 EN4ER = 0x7 王 ， 国 一 一 寺 
村 机 ert_miain.c Y | 083 } ; 
| 


四 projed | 念 eooks | (junaions| orenpptes| Li 











ComPIIInG maI 3s32 332 332 3z29.cC..。 
CompI1LIIPG Ia1L 332_ 332 _ 352_ 3Z30.cC。.， 
Compilzing PPDPLI WiIde 332.cC... 

二 nkIRnS。。- 

Pzoczam Szey Code=2300 RO-daza=32 RU-daca3s ZI-Gaca=1276 
FEZYCOTEILE: CZeaCIng9 PheXx 上 IJIe。， 

”七 二 5 二 Xftn 一 日 荆 ZZoz (3)，D aznanc1(3) 。 


| Move caretto the previous bookmark in the cuUrrent document 


图 9.10.6 编译 信息 


3. 加 载 HEX 文件 ,观察 实验 结果 


加 载 先前 生成 的 HEX 文件 , 按 下 仿真 按钮 并 调节 Logic State, 设 置 期 望 转速 ,如 图 9. 10.7 所 示 。 

从 代码 层面 看 ,Keil 工程 中 混合 使 用 了 手写 代码 与 自动 生成 代码 ,其 中 自动 生成 的 代码 
400 多 行 , 手 写 代 码 100 行 左右 。 自 动 生成 的 代码 占 到 了 总 代码 量 的 80% ,显著 提高 了 系统 开 
发 效率 ,降低 了 开发 成 本 。 一 般 来 说 ,在 基于 模型 设计 中 需要 手写 的 代码 大 多 为 硬件 底层 驱动 
代码 ,因此 ,在 大 型 项 目 中 ,系统 的 功能 与 算法 的 部 分 代码 更 加 复杂 ,而 硬件 底层 驱动 则 不 会 有 
明显 变化 ,这 样 一 来 ,自动 生成 代码 在 总 代码 量 中 的 比例 将 会 更 高 ,更 加 凸显 出 基于 模型 设计 
高 效率 、 低 成 本 的 优势 。 现 在 已 经 有 部 分 硬件 厂商 发 现 了 基于 模型 设计 的 优点 ,并 为 自己 的 产 
品 编写 了 驱动 模块 。 例 如 使 用 Microchip 公司 为 dsPIC 芯片 开发 的 dsPIC Blocksets, 可 以 自 


1 “484 。 陪 


加 第 9 章 ， 基 于 模型 的 设计 _ 上 四国 


动 生成 驱动 代码 ,达到 完全 不 需要 手写 代码 的 目的 。 
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和 生计 


图 9. 10.7 “Proteus 仿真 结果 
从 虚拟 硬件 测试 结果 看 ,电动 机 实际 转速 与 控制 信号 几乎 完全 一 致 ,也 和 本 章 9. 4 节 介 
绍 的 功能 验证 模型 ,9.7 节 的 SIL 测试 模型 的 功能 一 致 。 这 充分 证 明了 手工 代码 加 自动 生成 
代码 混合 使 用 ,有 效 地 提高 了 开发 效率 ,实现 了 基于 模型 设计 所 倡导 的 从 概念 到 实现 的 设计 
理念 。 
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附录 
Embedded MATLAB 支持 的 各 函数 





1. 航空 航天 模块 集 函 数 


ws 计算 四 元 数 的 范 数 


2 算术 运算 符 函 数 


3. 位 操作 函数 






交换 变量 高 低位 字 节 排 列 顺 序 





swapbytes 





"486。 





有 附录 Embedded MATLAB 支持 的 各 函数 这 ， 


4. 强制 数据 类 型 转换 函数 


二 变量 转换 为 另 一 种 数据 类 型 ar 建立 字符 ( 串 ) 阵 列 

所 查询 对 象 的 类 型 dbe 转换 为 双 精度 浮 点 数 

intg ,intl6 ,int32 转换 为 有 符号 整 型 数据 转换 为 布尔 型 数据 

了 转换 为 单 精度 浮 点 数 转换 数据 类 型 (不 改变 基础 数据 ) 
uint8,uintl6,uint32 | 转换 为 无 符号 整 型 数据 | 

s。 通信 工 具 箱 函数 

bi2de 二 进 制 向 量 转 成 十 进 制 un 十 进 制 向 量 转 成 二 进 制 

istrellis 判断 是 否 为 正确 的 栅 格 图 将 卷 积 码 多 项 式 转化 为 岂 格 图 
reosfir 升 余 纺 FIR 滤波 [ER 

6. 复数 运算 了 绞 数 

将 用 实 部 和 虚 部 构造 复数 comj | 返回 复数 的 共 生 

0 返回 复数 的 虚 部 若是 数值 数组 , 则 返回 1 

1 若是 复数 , 则 返回 0 若是 标量 数组 , 则 返回 1 

real 返回 复数 的 实 部 | anwrap | 校正 相位 角 , 得 到 平滑 的 相位 曲线 
7. 数据 类 型 沽 数 













找 ” 述 
确定 输入 是 否 为 单元 阵列 
验证 输出 参数 值 









验证 输入 参数 值 


isce]] 


nargoutchk 





8， 导数 与 积分 函数 







cutmtrapz 





梯形 数值 积分 
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9. 离散 数学 函数 


最 小 公 倍数 


nchoosek 





10. 错误 处 理 函 数 


描述 


| 
汉 
克 








ER 当 运行 环境 被 破坏 时 ,报告 错误 显示 错误 信息 ,并 终止 函数 
11. 指数 函数 

以 e 为 底 的 指数 函数 expm | 短 阵 指数 函数 

log 自然 对 数 os 以 2 为 底 的 对 数 
log10 以 10 为 底 的 对 数 osp 计算 lg(1 十 z) 
nextpow2 以 2 为 底 的 对 数 , 并 向 上 取 整 实数 根 

同和 非 负 实 数 的 自然 对 数 非 负 实数 的 等 

12.。 滤波 和 卷 积 了 尖 数 

卷 积 或 多 项 式 乘法 二 维 卷 积 

deconv 反 卷 积 或 多 项 式 除 法 detrend 去 除 和 矩阵 中 的 线性 趋势 
五 lter 一 维 数 字 滤 波 二 维 数字 滤 波 


13. 定 点 工具 箱 疯 数 


到 
居 
性 
二 


函数 名 
abs 求 绝 对 值 
add 两 个 对 象 相 加 (fimath 对 象 ) 
ail 确定 数组 元 素 是 否 都 为 非 0 
any 确定 数组 是 否 有 非 0 元 素 


因数 名 
bitand 
bitandreduce 
bitcmpP 
bitconcat 
bitget 
bitor 
bitorreduce 
bitreplicate 
bitrol 
bitror 
bitset 
bitshift 
bitsliceget 
bitsll 
bitsra 
bitsri 
bitxor 
bitxorreduce 
cei 
complcx 
conj 
cony 
convergent 
cordiccexp 
cordiccos 
cordicsin 
cordicsincos 
ctranspose ， 
diag 
disp 
divide 
doubie 
end 
eps 
eq 
笃 
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续 表 


位 求 与 

连续 位 闻 相 与 

位 取 反 

合并 字符 串 

取 特 定位 

位 求 或 

连续 位 间 相 或 

复制 合并 字符 串 

位 左 移 

位 右 移 

特定 位 置 1 

位 移动 

取 连 续 位 部 分 

位 逻辑 左 移 

位 算术 右 移 

位 逻辑 右 移 

位 异 或 

连续 位 间 相 异 或 

沿 十 ce 方向 取 整 

用 实 部 . 虚 部 构造 复数 对 象 
共 轧 复数 晒 数 

卷 积 或 多 项 式 乘法 

向 最 接近 的 倘 整 数 取 整 
基于 CORDIC 的 复 指数 近似 
基于 CORDIC 的 余弦 近似 
基于 CORDIC 的 正弦 近似 
基于 CORDIC 的 正弦 与 余弦 近似 
复 共 入 转 置 

建立 对 角 抢 阵 或 获取 对 角 阿 量 
显示 和 邱 阵 与 文本 

对 象 相 除 

双 精 度 浮 点 值 ( 有 意义 的 值 ) 
数组 的 最 后 一 个 下 标 

重 化 对 象 的 相对 量化 精度 
相等 (有 意义 的 值 ) 
构造 fi 对 象 
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柄 基于 模型 的 设计 一 MCU 篇 


函数 名 


fiiter 
fimath 

乒 x 

floor 

ge 

get 

getlsb 
getmsb 

gt 

horzcat 
imag 

int8 ,int16 ，int32 
iscolumn 
tsempty 
isequal 

isfi 

isfimath 
isfimathlocal 
isfinite 

isinf 

1Snan 
isnumeric 
isnuImerictypPe 
isreal 

1srowW 
isscalar 
jssigned 
isSVector 

je 

length 
logical 
lowerbound 


1sb 


续 表 


和 对 象 的 一 维 滤 波 器 

构造 fimath 对 象 

没 零 方向 肥 整 

沿 一 ce 方向 反 整 

大 于 等 于 (有 意义 的 值 ) 
获得 对 象 属性 

最 低 有 效 位 

最 高 有 效 位 

大 于 (有 意义 的 值 ) 
横向 合并 多 重 对 象 
求 虚 部 函数 

内 赴 8.16、.32 位 整形 数据 存储 对 象 的 整数 值 
判断 对 象 是 天 为 列 向 量 
判断 数组 是 否 为 空 

判断 是 否 相 等 (有 意义 的 值 ) 
判断 变量 是 否 为 五 对 象 
判断 变量 是 否 为 fimath 对 象 
判断 下 对 象 是 否 附 加 有 fimath 对 象 
检查 数组 中 的 有 限 元 素 
检查 数组 中 的 无 限 元 素 
判断 数组 元 素 是 否 为 NAN 
判断 输入 是 否 为 数值 数组 
判断 变量 是 否 为 数值 型 对 象 
判断 数组 元 素 是 否 为 实数 
判断 对 象 是 否 为 行 向 量 
判断 输入 是 否 为 标量 
判断 对 象 是 否 有 符号 
判断 输入 是 否 为 向 量 

小 于 等 于 (有 意义 的 值 ) 
查询 向 量 的 维 数 

将 数字 量 转化 为 远 辑 量 

五 对 象 的 下 界 范 围 

下 对 象 最 低 有 效 位 的 缩放 
小 于 (有 意义 的 值 ) 

皇 对 象 数组 中 的 最 大 元 素 
定点 矩阵 的 均值 


郴 数 名 


median 


ImPY 
mrdivide 
mtimes 
ndims 

ne 

nearest 
numberofelement 
numerictype 
permute 
Plus 

pow2 

Power 

range 
rdivide 

real 
realrmax 
realmin 
reinterPpretcast 
repmat 
rescale 
reshape 
round 

sf 

sign 

single 


Size 


sub 
subsasgn 
subsref 


SUI 
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续 表 


定点 矩阵 的 中 值 

在 对 象 数组 中 的 最 小 元 素 

和 对 象 矩阵 间 的 差 值 
定点 和 矩阵 求 苦 

两 个 对 象 相 乘 ( 用 fimath 对 象 ) 
和 矩阵 右 除 

全 对 象 矩 阵 乘 积 

求 矩 阵 维 数 

不 等 于 (有 意义 的 值 ) 

向 最 接近 的 正 整数 取 整 

皇 数 组 中 数据 元 素 的 个 数 
构造 数值 型 对 象 

任意 改变 矩阵 维 数 序列 

fi 对 象 矩 阵 相 加 

基 2 标量 浮 点 数 

定点 矩阵 中 对 各 元 素 求 宕 
fi 或 量化 对 象 的 数值 范围 
数组 右 除 

求实 部 函数 

最 大 浮 点 数值 

最 小 浮 点 数值 

转换 定点 数据 类 型 (不 改变 基础 数据 ) 
复制 并 排列 矩阵 郴 数 

皇 对 象 缩放 

矩阵 维度 变换 

含 人 取 整 

构造 有 符号 定点 数值 型 对 象 
符号 函数 

皇 对 象 的 (有 意义 的 ) 单 精度 浮 点 值 
查询 矩阵 的 维 数 

对 向 量 中 各 元 素 排序 
平方 根 函 数 

两 个 对 象 相 减 (用 fimath 对 象 ) 
下 标 分 配 

下 标 引 用 

对 向 量 中 各 元 素 求 和 
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续 表 
函数 名 撒 ” 述 
人 人 对 象 的 元 索 间 相 乘 
transpose 转 置 
tri 取 和 矩阵 的 下 三 角 部 分 
和 取 和 矩阵 的 上 三 角 部 分 
ufi 构造 无 符号 定点 数值 型 对 象 
itSvaiotl6.aint32 内 置 8.16、32 位 无 符号 整 型 数据 存储 对 象 的 整数 值 
人 | 对象 数组 取 反 
-元 加 
ao fi 对象 的 上 界 范围 
纵向 合并 多 重 乓 对 象 


14. 直方 图 函数 





1$. 图 像 处 理工 具 箱 函 数 














创建 预定 义 的 二 维 滤 波 器 将 labelmatrix 换 为 RGB 图 像 


fspecial 





label2rgb 





16. 输入 输出 函数 


Ta 


17. 插值 和 几何 运算 











函数 中 输出 变量 个 数 


nargin 





描述 


2 笛 卡 儿 坐 标 到 极 坐 标 转换 [EC 笛 卡 儿 坐 标 到 球面 坐标 转换 


函数 名 





快速 一 维 线性 插值 


meshgrid 构造 三 维 图 形 用 xz,y 阵列 
球面 坐标 到 笛 卡 儿 坐 标 转换 [0 
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18. 线性 代数 


描 ” 述 


linsolve 求解 线性 系统 方程 
Schur 分 解 





19. 逻辑 运算 函数 


and 妈 辑 与 位 求 与 

We 位 取 反 bitget | 读 取 特定 数据 位 
于 二 位 求 或 特定 位 置 1 

本 逻辑 反 | 逻辑 或 


20. 矩阵 和 数组 函数 





方差 计 和 
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量 - 基于 模型 的 设计 一 一 MCU 篇 








续 表 
isinteger 判断 输入 是 否 是 整数 数组 | islogical ”| 判读 输入 是 否 是 符合 逻辑 的 数组 
ndims 维度 数 mnz | 算 阵 中 非 零 元 素 个 数 
planerot prod 数组 元 素 积 
qr 直角 三 角 转 换 随机 序列 
ra 矩阵 的 秋 。 reond | 甜 阵 公约 数 估计 
in 改变 维度 | sign | 符号 函 数 
区 矩阵 大 小 | sn | 升序 或 降序 排列 元 


21. 非 线性 数值 方法 






平面 域 上 二 重 积分 的 数值 估计 










用 自 适应 Gauss - Kronrod 正 交 法 求 
数值 积分 
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22. 多 项 式 画 数 






数据 的 多 项 式 拟 全 
求 多 项 式 的 根 









ce 向 正 无 穷 方向 取 束 向 最 接近 的 偶 整数 取 整 
wd 正 无 穷 方向 取 整 ,并 取 最 近 的 整数 


25S. 排序 函数 


MATLAB 支持 以 下 的 功能 : 


本 查找 两 个 向 量 的 交集 | ismember | 判断 矩阵 元 素 是 否 属于 集合 


26. MATLAB 信号 处 理 函 数 






卷 给 与 多 项 式 乘 法 
2 维 离散 傅 里 叶 变换 
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二 : 基于 模型 的 设计 一 一 MCU 篇 人 


适用 于 实数 和 复数 的 数字 滤波 器 过 
滤 输 人 数据 


freqspace 频率 响应 的 频率 间 酮 ifft 离散 傅 里 叶 逆 变换 


续 表 


fftshift 






































ifft2 ifft 与 ifft2 输出 重 排 
将 零 极 点 表示 的 滤波 器 改 用 传递 函 
数 表示 
27. 信号 处 理工 具 箱 函 数 
函数 名 摘 ” 述 
barthannwin 改进 Bartjett 一 Hann 窗 ( 产 生 代 码 时 需要 信号 处 理 模 块 集 的 许可 ) 
bartleti bartlett 窗 
besselap 贝 塞 尔 模拟 低 通 滤波 器 原型 
bitrevorder 按 位 倒序 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
da blackman 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
blackmanharris 最小 4- term Blackman - Harris 窗 
bohmanwin bohman 窗 ( 产 生 代 码 时 需要 信号 处 理 模块 集 的 许可 ) 
butap | 巴特 沃 斯 波 波 器 原型 
butter 巴特 沃 斯 滤波 器 设计 (产生 代码 时 需要 信和 号 处 理 模块 集 的 许可 ) 
buttord 巴特 沃 斯 滤波 器 的 阶 数 和 截止 频率 
cfirpm 复合 非 线 性 相位 等 波纹 FIR 滤波 器 设计 (产生 代码 时 需要 信和 号 处理 模块 集 的 许可 ) 
cheblap 切 比 雪夫 I 型 模拟 低 通 滤波 器 原型 
cheb2ap 切 比 雪夫 开 型 模拟 低 通 滤波 器 原型 
cheblord 切 比 雪夫 I 型 模拟 低 通 滤波 器 阶 数 
cheb2ord 切 比 下 夫 II 型 模拟 低 通 滤波 器 阶 数 
chebwin 切 比 雪夫 窗 ( 产 生 代 码 时 需要 信和 号 处 理 模块 集 的 许可 ) 
cheby1l 切 比 雪 夫 I 型 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
cheby2 切 比 雪夫 了 型 滤波 器 设计 (产生 代码 时 需要 信和 号 处 理 模块 集 的 许可 ) 
dect 离散 余弦 变换 
downsample 降低 采样 速率 
dpss 离散 长 球面 序列 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
ellip 棋 圆 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
wiipep 福 圆 模拟 低 通 小 波 器 原型 
ellipord 椭圆 滤波 器 的 最 小 阶 数 
filtfilt 零 相位 数字 滤波 = 
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上 函 数 名 
firl 
fir2 
fircls 
firclsl 
firls 
firpm 
和 rpmord 
firrcos 
由 attopwin 
freqz 
gaussfir 
gauSsSwWin 
hamming 
hann 
idct 
intfilt 
kaiser 
kaiserord 
levinson 
maxflat 
nuttalljwin 
parzenwln 
rectwin 
resarmpjle 
sgolay 
soOsfit 
taylorwin 
trtang 
tukeywin 
upfirdn 
upsample 
XcOrr 


yulewalk 
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续 表 
描述 
窗 函 数 有 限 冲 激 响 应 法 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
频率 抽样 有 限 冲 激 响应 法 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
最 小 平方 约 东 ,FIR 多 频带 滤波 器 设计 (产生 代码 时 需要 信和 号 处 理 模块 集 的 许可 ) 
最 小 平方 约束 , 低 通 高通、 线性 相位 FIR 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
最 小 平方 线性 相位 FIR 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
Parks - MeClellan 最 佳 FIR 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
Parks -~ MecClelian 最 佳 FIR 滤波 器 评价 (产生 代码 时 需要 信和 号 处 理 模块 集 的 许可 ) 
天 余 交 滤 波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
平 顶 窗 ( 产 生 代码 时 需要 信和 号 处 理 模块 集 的 许可 ) 
数字 滤波 的 频率 响应 
高 斯 脉冲 成 型 FIR 滤波 器 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
高 斯 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
汉 明 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
汉 宁 窗 (产生 代码 时 需要 信和 号 处 理 模块 集 的 许可 ) 
离散 余弦 道 变换 
内 搬 FIR 小 波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
遍 瑟 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
凯 瑟 窗 FIR 滤波 器 设计 参数 估计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
Levinson -~ Durbin 递归 法 
一 般 数字 巴特 沃 斯 FIR 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
Nuttall 最 小 4 - term Blackman - Harris 窗 
Parzen 窗 ( 产 生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
矩形 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
调整 采样 率 
Savitzky - Colay 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
二 价 TIR 滤波 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
泰勒 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
三 角 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
tukey 窗 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
增 采 样 、 然 后 FIR 滤波 、 青 减 采 样 
提高 采样 速率 
互相 关 ( 产 生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 
递归 数字 滤波 器 设计 (产生 代码 时 需要 信号 处 理 模块 集 的 许可 ) 


量 : 基于 模型 的 设计 一 一 MCU 篇 





28. 特殊 数值 
eps 精度 容许 误差 无穷小 ) | in | 无 淄 大 
人 特定 数据 类 型 的 最 大 整数 intmin | 特定 数据 类 型 的 最 小 整数 
RN 非 数 圆周 率 
ra 产生 随机 分 布 矩 阵 | andn | 产生 正 态 分 布 矩 阵 
RE 最 大 浮 点 数值 | amn | 最 小 浮 点 数值 
29. 专用 数学 函数 
人 逆 补 差 函数 比例 互补 误差 函数 
gammaln | gamma 对 数 醒 数 | 
30. 统计 函数 

函数 名 描述 函数 名 描述 
corrcoef 相关 系数 Imean 求 向 量 中 各 元 素 均 值 
RE 求 向 量 中 中 间 元 素 | mode | 数组 中 出 现 频率 最 高 的 什 
std 求 向 量 中 各 元 素 标准 差 ar | 
31. 字符 串 殉 数 
bin2dec 二 进 制 字符 串 转换 为 十 进 制 数 求 最 大 无 符号 浮 点 整数 
blanks 产生 空 字符 申 char | 生成 字符 让 
Se 十 六 进 制 字符 串 转 换 为 十 进 制 如 果 是 字符 则 返回 真 
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32. 结构 体 函 数 








isfield 


ISStruUct 






一 Ta 
如 果子 段 属于 结构 则 返回 真 me | 


如 果 是 结构 则 返回 真 







生成 结构 数组 


正切 ,结果 以 角度 表示 


六 
首 


反 余 抽 | sesed | 所 侠 出 ,结果 以 角度 表示 
反正 切 四 象限 反 转 正切 

反正 切 ,结果 以 角度 表示 反 双 曲 正切 
EC 

secd 正 割 ,结果 以 角度 表示 
aa 
了 | 

RhE 切 | 


双 曲 正切 


34. 视频 与 图 像 处 理 模块 集 函 数 


函 数 名 描述 
estimateFundamentalMatrix 由 立体 图 像 相关 点 估计 基本 和 矩阵 
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